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WELCOME TO 
THE OFFICIAL 
MAGAZINE 


igital making is fun, 


incredibly important. Whether you’re 


building something 
or taking an existing gadget 
down to add your own touch 


that we think about how things actually work. 


Whether we like it or not, 


where small impenetrable black monoliths 
deliver our entertainment and information. 


but it’s also 
from scratch, 
and stripping it 


of magic, it’s vital 


we live in a world 


We don’t have to think abou 


t how they work 


and their designers don’t want us to. 


Digital making with the Raspberry Pi is the 


perfect antidote, and we’ve put together a 


selection of easy and interm 


ediate projects 


for you to try in our cover feature starting 
on page 14. Elsewhere this issue we’re also 
building some great devices, including an LED 


thermometer, a gadget that 


turns Python code 


into art, and a simple reactions game, among 


other things. 
Happy making! 


Russell Barnes 
Managing Editor 
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rIF IA 


BIRTHDAY 


PARLY 


Raspberry Pi celebrates its first five years 


Digital 

makers shared 
inspiring projects 
with the Raspberry 
Pi community 


early 1,500 members of the 
Raspberry Pi community 
attended the Fifth Birthday 
Party for the organisation. 
Held at Cambridge Junction 
arts centre on 4/5 March, the 
Big Birthday Weekend 2017 
saw hundreds of Raspberry Pi 
community members gather 
together to share projects and cake. 
The Twitter hashtag #piparty 
even became a Twitter Moment, 
gaining global coverage. 
The party featured workshops 
and talks from the Raspberry Pi 


Foundation, Code Club, and active 
members of the community. 

The MagPi team had a stand at 
the party. We showed off recent 
projects including the PiGRRL2 
from the cover of issue 55. 

Sam Aaron and Ben Smith’s 
Sonic Pi workshop was especially 
impressive. They demonstrated 
live coding with a mind-blowing 
live performance (watch online: 
magpi.cc/2m6ml1Qm). 

“We describe our mission as 
putting the power of digital making 
in the hands of people all over the 
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Philip Colligan welcoming people to 
the Big Birthday Party 2017 


world,” said Philip Colligan, CEO 
of Raspberry Pi Foundation. 

In the main hall, dozens of 
digital makers showed off their 
latest builds. Party-goers played 
Spanner Spencer’s four-player 
Gauntlet, Steve Upton’s Pi 
Bash, and NuStem’s Technology 
Wishing Well. 


A special year 

“It’s been another interesting, 
weird, and surprising year for 

us at Raspberry Pi,” said Eben 
Upton, founder and CEO of 
Raspberry Pi Trading. 

The Raspberry Pi is an incredibly 
important computer because it 
exists in a world of computers 
that are expensive or inaccessible. 
“You can’t let your child play with 
the family computer any more 
than you let your child take the 
family car apart,” explained Eben. 
The Raspberry Pi is a fantastic 
platform for digital making and 
experimentation. It’s fun and 
low cost. 

One interesting development is 
that Raspberry Pi has become an 
advocate for British manufacturing. 
“T didn’t think that is what we’d be 
when we built our first units five 
years ago,” said Eben 

“We are not building units in 
the UK because we are patriotic,” 
he explained. “We are building 
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FIFTH BIRTHDAY PARTY News 


Our very own Rob Zwetsloot 
hosting a workshop on 
writing for The MagPi 


Writing for 


4 


The 


them in the UK because we are 
cheapskates who want to build 
cheap but high-quality products.” 
It turns out that the cheapest place 
to build products is here in the 
United Kingdom. 


make, using the resources, and the 
infrastructure we create, to make 
the difference.” 

Fran Scott ended the party 
with a Live Coding Explosions 
show, using a Raspberry Pi to 


We are as much a movement 
as we are an organisation 


“We have to remember,” 
said Eben, “that we are as 
much a movement as we are an 
organisation. For every one person 
inside the organisation there are 
10 or 100 more people out there 
in the world using the things we 


blow up hydrogen balloons on 
stage (magpi.cc/2m6ArBn). It 
was “absolutely wonderful to join 
Raspberry Pi and Code Club to 
celebrate their fifth birthday,” 
remarked Fran. “Thanks so much 
for the invite.” 


Hands-on workshops and maker tables allowed 
children to create robots and all kinds of projects 
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SALES SOAR ABOVE COMMODORE 64 


SALES SOAR ABOVE 
COMMODORE 64 


Raspberry Pi becomes world’s third-best selling computer platform 


ecent Raspberry Pi sales 

figures revealed that the 

humble board is now the 
world’s third-best selling general- 
purpose computer platform, 
edging past the sales of the 
Commodore 64. 

“The Commodore 64 had, until 

recently, the distinction of being the 
third most popular general-purpose 
computing platform,” Eben Upton, The Commodore 64 was a 
CEO of Raspberry Pi Trading tolda ibe iaedlay sad ie et 
crowd at the fifth birthday party. 
‘That’s what I’m here to celebrate,” 


he said, “we are now the third most considering that the original plan as if the Raspberry Pi computer 
popular general-purpose computing was to produce between 10,000 and __ platforms will keep selling for 
platform after the Mac and PC.” 20,000 boards. many years to come. 


Our analysis shows that the 


Eben also revealed that the Pl ZCTO W Raspberry Pi 3 has accounted for 


almost a third of all Raspberry Pi 


sold about 100,000 in its first four days Miner jsitsnexe ois 


immediate predecessor, the 


There are approximately “This is really cool,” said Eben. Raspberry Pi 2 (which has the 
1.25 billion PCs sold. Apple’s CEO “And we did it together, and it’s same board shape but a slightly 
Tim Cook has claimed sales of kind of wonderful.” slower CPU). These two boards 
80 million Intel Mac computers account for over half of all 
using the OS X platform. Sales rise Raspberry Pi boards sold. 
Outselling the Commodore Eben also revealed that the Pi The rest of the sales are shared 
64 cements Raspberry Pi in the Zero W sold about 100,000 units between older models. The original 
annals of history. It’s not bad in its first four days, so it looks Model A accounts for just two 


percent of sales. 

There is some debate 
surrounding the total sales of the 
Commodore 64. The 12.5 million 
figure comes from an analysis of 
serial numbers by Michael Steil 
(magpi.cc/2mI2Egg). 

Michael’s analysis of Commodore 
64 platform sales is based on 16 
different board revisions, used in 
a range of ‘64’ computers such as 
the PET 64, Educator 64, and C64GS 
games console. However, it does 
not include the Portable SX-64 and 
Commodore 128, as these hada 
different architecture. 


Raspberry Pi3 - 28% 
Raspberry Pi 2B - 21% 
Raspberry Pi B+ - 21% 
Raspberry PiB - 21% 
Raspberry Pi Zero - 4% 
Raspberry Pi A+ - 3% 


Raspberry PiA - 1% 


Raspberry Pi Zero W - 1% 
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Four new projects for Pi Zero W 
= + 
imoroni has released four new project kits to 
p sit alongside the new Pi Zero W board. Each 
kit contains a Pi Zero W board and GPIO pin Zs , 


header, requiring some basic soldering. Light up your room by programming the multicoloured LEDs 
“As soon as we heard about the Pi Zero W, we knew 5 

that its features would make IoT projects much more - 

approachable,” says Paul Beech, Pimoroni 

co-founder. “These kits are made to appeal to 

everyone, to inspire people to try IoT and crafting.” 
The Starter Kit (£32) contains a Raspberry Pi, 

microSD card, Pibow case, and Blinkt! LED strip. 


These kits are 
made to appeal to 
everyone 


A Mood Light Kit (£30) comes with a Pimoroni 
Unicorn pHAT (a grid of 32 programmable RGB 
NeoPixel LEDs) and a mood light stand. 

The Scroll Bot Kit (£35) comes with a Pimoroni 
Scroll pHAT HD and robot stand. Finally, the Pirate 
Radio Kit (£40) comes with a pHAT Beat DAC, 
5W speaker, and radio stand. 

More information can be found on the Pimoroni 
website (magpi.cc/2mbbAMK). 
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THIN CLIENT 


Access Windows and cloud computing 


from a Raspberry Pi device 


esktop virtualisation firm 

NComputing has used the 

Raspberry Pi 3 to build 
a thin client computer. Thin 
clients are lightweight computers 
that access a remote server, 
typically a cloud-based computer 
or virtualisation environment. 
The server does all the heavy 
computational lifting, while the 
thin client provides the interface. 
The RX300 supports virtual 
desktops from nine popular 
Windows operating systems, 
including Windows 10 and 
Windows Server 20106. 

“Looking at the IT industry, 
Raspberry Pi has established itself 
as a robust and reliable device, 
one increasingly becoming viable 
within an enterprise setting,” 
comments Christos Golias, head 
of sales at Tarox AG, Germany. 
“The virtualisation environment 
provided by NComputing’s vSpace 
Pro 10 software coupled with the 
affordability of an RX300 offers an 
attractive IT deployment solution 
for businesses.” 


centrally ma 
solu 
The Raspber 
computer is 


innovation, i 
versatility, 


Matched wit 
software, we 


The RX300 
taxes, and in 
subscription 


what IT admi 
end users want.” 

You can boot the RX300 into 
two modes: Thin Client Mode or 
Raspbian, enabling users to access 
the Linux OS. 


Young Song, NComputing 
CEO, explains: “Our vision is to 
make easy-to-use, powe 


rful, and 
naged computing 


tions even more affordable. 


ry Pi single-board 
renowned for its 
ts portable size, 


and economic viability, 
making it the perfect thin client. 


h our vSpace Pro 
know it will deliver 
ns need, and what 


costs $99 excluding 
cludes a one-year 
to vSpace Pro 10. 


The RX300 is a thin client computer 
that provides cloud access to 
Windows on a Raspberry Pi board 
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There was lots of love for our story on bringing Teletext 
back with the help of the Raspberry Pi. 


magpi.cc/2lyWhX 


How the Raspberry Pi team managed to squeeze 
wireless networking and Bluetooth onto the tiny 
Pi Zero W board. 


M The e he aie et 
agPi re 
opeceriys [lll Jh Se vue 
THE OFFICI AL Gos heen 
. TO DONA’ 


Give when ev buy @ ti 
Girt st Junction ce vk /s 
Put cosh in the dr 


magpi.cc/2mmx8mn 


Miss the #PiParty? We've got a little gallery of photos 
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BLOG IN A BOX 


IN A BOX 


Creators of WordPress.com build Raspberry Pi platform 


log In A Box is a new tool 

for Raspberry Pi from 

Automattic, the company 
that developed WordPress.com. 
The software turns your 
Raspberry Pi into a blogging 
platform that serves up a website, 
similar to WordPress. 

However, Blog In A Box takes 
full advantage of the Raspberry Pi 
hardware. You can automatically 
capture photographs from the Pi 


Camera Module or access data from 


the Sense HAT. 

“We wanted to do something 
with the Raspberry Pi,” says team 
member John Godley. 

“We decided we’d really like an 
easy single package that would 
put a fully working WordPress 
system onto a Raspberry Piina 
way that will be useful for people 
to experiment and learn with,” 
reveals John. 

“We like to tinker ourselves,” 
he adds. 

Blog In A Box enables makers to 
“connect to Raspberry Pi sensors 
and hardware, and have it all 
viewable in a smart-looking way,” 
according to John. 


Blog In A Box 
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Basic Setup 


These settings allow you to connect to your Pi after it boots. Leave blank if you don't need wifi. 


Wi Ntvork: 
Wit Paso! 


Optionally supply your SSH public key to login without a password. 


Public SSH key Select 


Need more 


« Go Back Continue! 


The installer tool is available Above A custom installer is used to burn a 
. bootable SD Card image pre-loaded with 
for Mac OS X, Windows, and one ordeals 
Linux. Using it, you configure the 
settings for your Raspberry Pi WordPress system with MySQL, 
(WiFi details, admin password). PHP, and Nginx all installed and 


Blog In A Box takes 
full advantage of the 
Raspberry Pi hardware 


It then burns an image file direct configured,” explains John. “When 
toa microSD card. “Boot this it’s finished booting, WordPress 
card and you have a working is immediately available at 


) 


bloginabox.local. 
The WordPress plugin and tools 
give you access to anything you 
® Temperature connect to your Raspberry Pi. 
“Weve added built-in support for 
the Camera Module and a Sense 
re) HAT, both of which can be controlled 
%» ? 4 je 1 C from WordPress and set to capture 
data and post it automatically.” 
John tells us, “Everything is 
open source and we’re hoping 
people can use it as a good base 
for all kinds of purposes.” 
Download the Blog In A Box 


4 53 1 % installer tool from inabox.blog. 


Left Data captured from a Raspberry Pi 
Sense HAT can be automatically posted 
toa blog 


® Humidity 
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CAMBRIDGE THEME FOR PIXEL 


THEME FOR PIXEL 


© OCE*O 


New desktop images for Raspberry Pi 
produced to honour Cambridge roots 


selection of 
for 


he Raspberry Pi Foundation has released a 
new wallpapers and a screensaver 
the Raspbian with PIXEL operating system. 


The optional new look for Raspbian is based on the 


city of Cambridge, UK. 


“The connection between Raspberry Pi and 
Cambridge runs a lot deeper than mere geography,” 


says Simon Long, 
He explains 


UX engi 


neer. 


, “Raspberry Pi was founded with the 


aim of increasing the number of applicants to study 
computer science at the University of Cambridge. The 
processor core which powers the Raspberry Pi was 


developed in the city by A 


RM, the hugely successful 


microprocessor company which itself grew out of 


Acorn, one of the original 
home computer revolutio 
success story.” 


pioneers of the 1980s 
n, and another Cambridge 


A few months ago, Eben Upton and Simon were 


looking at the beautiful ci 
offers as screensavers on 


ty flyover videos that Apple 
the Apple TV. “We thought 


that it would be great if we could do something 
similar for Raspbian, with Cambridge as the subject,” 
recalls Simon. “So we enlisted the help of Cambridge 
Filmworks (magpi.cc/2mHzz1D).” 

Cambridge Filmworks specialises in filming with 
drones, and they put together a video showing 
the best of Cambridge’s architecture, recorded 


from the air. 
The new screensaver is 


gorgeous. Once installed, 


you access it via Menu > Preferences > Screensaver. 


To get the new theme, first update the 
Raspbian package list in Terminal: 


sudo apt-get update 


To install the wallpapers: 


sudo apt-get install 


cantab-wallpaper 


To install the screensaver: 


sudo apt-get install 


To install both: 
sudo apt-get install 
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cantab-screensaver 


cantab-theme 


3 Th 9 e120 Left The Senate 
House of the 
University of 
Cambridge, lit up 
at the e-Luminate 
Festival 2017 
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20+ new projects for your PI robot car. 


BrickPi3 


LEGO MINDSTORMS + RASPBERRY PI 


www.dexterindustries.com 
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INCREDIBLE 
RASPBERRY PI! 


PROJECTS 


Get started with digital making with these incredible projects 


igital making is really important to the 

Raspberry Pi community. It’s not enough for 

us to just buy a Raspberry Pi and just set it 
up. We have to make stuff too. 

Here at The MagPi, we want to help people make 
things. Making is fun. It’s about getting your 
creative juices flowing. 

In the following pages, we present a stack of 
ideas for things to research and make with your 
Raspberry Pi. 

These are practical projects that anybody can 
make. Some are simple kits like the LEGO NES 
case; others are Blue Peter-style hacks like the 
Pi-powered binoculars. 

They’re designed to be challenging, but 
definitely doable. 

More advanced makers will want to look at 
Sixlab’s YouTube Drone. This combines drone 
technology with a Pi Camera and 4G connectivity. 
It’s the cutting edge of maker-tech. 

There’s little more important than being a digital 
maker in the modern world. The world is full of the 
‘new shiny’: toys and trinkets that people pay for 
but never truly understand. It’s way more important 
to make your own things. They may not always be as 
shiny, but they’re worth so much more. 
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EASY ROBOT 


SIE: 


Ss CamJam EduKit #3 - Robotics 


Magri 


MagPi 


YOU'LL 
NEED 


A power adapter is attached to the rear 
of the display, allowing both the monitor 
and USB adapter to be hooked up toa 
single cable 


The Raspberry Pi is fixed to the rear of 
the display. The DAKboard software is 
set up to launch in full-screen mode 
when the power is turned on 


A short HDMI cable is used to 
connect the Raspberry Pi directly 
to the HDMI input on the display 


SATURDAY 


FRIDAY 
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Configure Raspbian 


sudo apt-get install unclutter 


sudo nano /boot/config. txt 


# Display orientation. 
Landscape = ®, Portrait = 1 
display_rotate=1 


# Use 24 bit colors 
framebuffer_depth=24 


sudo nano ~/.config/1xsession/ 


LXDE-pi/autostart 


@xset s off 

@xset -dpms 

@xset s_ noblank 

@chromium- browser 
--noerrdialogs --incognito 
--kiosk http: //dakboard.com/ 
app/?p=YOUR_PRIVATE_URL 


IK board 


>STEP-03 


ea 
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PINOCULARS 


The PiNoculars project is an excellent way to recycle an old pair 
of binoculars into a high-tech zoom recording device 


he Raspberry Pi Camera 
Gp Module is a great tool for 

digital making. With it you 
can quickly add an 8-megapixel 
camera to the Raspberry Pi board. 

It connects directly to the 

Raspberry Pi using the CSI camera 
interface, a thin cable socket on 


> Binoculars 
> Raspberry Pi 


> Camera Module 


> Adafruit the Raspberry Pi board. 
toughsereen The Camera Module is fantastic 
display 


for video and still photography 
projects, such as time-lapse 
cameras. OpenCV (opencv.org/) 
software makes it easy to add 
computer vision to your projects. 
With this, you can train a 
Raspberry Pi to identify objects and 
react accordingly. 

The PiNoculars project is 
one of our favourite Camera 
Module hacks. 


> Foam 
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Created by digital maker Josh 
Williams, PiNoculars are a regular 
set of binoculars, with a Raspberry 
Pi Camera module fixed over one 
of the eyepieces. 

The Raspberry Pi is connected 
to the top of the binoculars along 
with a touchscreen display. The 
whole assembly is powered by 
a Goal Zero AA battery pack 
(magpi.cc/2m9w6xr). 

“T was on 18-hour road trip back 
from Colorado to Michigan with my 
wife, and I was restless,” Josh tells 
us. “I had brought the Raspberry 
Pi and Pi Camera Module along 
to play around with time-lapse 
photos in the mountains.” 

When Josh looked at his pair of 
binoculars, he had a brainwave. 
“Raspberry Pi and Camera Module 


JOSH WILLIAMS 


Josh helps run local maker 
spaces (All Hands Active and 
Maker Works). He builds amazing 
places for people to work on 
their projects. 
magpi.cc/2mg9A4pz 


and duct tape made for a crude 
prototype,” says Josh. 

When he got home, Josh set about 
refining the build. He now has 
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feature 


a, 


he finished project enables you to } 
record long-distance video footage ' x. 
using an intelligent device “ 


ATTACH A 
CAMERA MODULE 


>STEP-02 

Attach the camera 

Cut out a foam circle the 
same size as the eyepiece 
on your binoculars (it needs 
to cover the eyepiece 
completely). Mark an X in 
the centre and draw an 8x8mm 
square in the centre of the circle. Push the 
Camera Module into the foam and position 
it in front of the eyepiece. 


There are anumber of people 
who've combined the Raspberry Pi 
with microscopes and telescopes 


=— 
Challenging 
BUILD A 


MAHMUT 


Mahmut is a computer 
engineer and maker. 


He is working with 
his friend, Metin, on 
Sixfab Raspberry Pi 
4G/LTE projects. 
magpi.cc/2nSlpvp 


YOUTUBE DRONE 


Add a Camera Module to a drone to broadcast footage straight to YouTube 


> Drone Kit (and 
RC controller) 


> Sixfab 4G/LTE 
shield 


> Camera Module 


his smart drone broadcasts 
footage over a cellular 

data connection direct 

to YouTube. 

The YouTube Drone is a great 
project because it incorporates 
so many different Raspberry Pi 
features: video recording, flight 
control (either RC or automated), 
YouTube integration, and data 
network access. 


It’s also fundamentally inspiring. 


Hooking up a drone to a Raspberry 


The UK Civil Aviation Authority's ‘The 
Drone Code’ is a guide to flying drones 
for fun (magpi.cc /2nRZAwz2). 


In a nutshell: Keep your drone under 
120m and 50m away from other people, 
vehicles, or buildings. Stay clear of 
airports, airfields, and aeroplanes. Keep 
your drone in your field of vision (within 
500m) at all times. 
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Pi with network coverage lets you 
test a lot of future technologies. 

There’s potential to integrate it 
with computer vision technology, 
as well as automatic flight. 

This project was built by Mahmut 
and Metin, a computer engineer 
from Sixfab and his maker friend. 

“The Sixfab 4G/LTE shield offers 
high-speed internet connection to 
Raspberry Pi,” says Mahmut. 

Mahmut and Metin started with 
a drone kit: a Super Multicopter 


Set - Make Yourself Drone Kit 
from Robotistan (£180/S220, 
magpi.cc/2mgXMjv). 

The drone set needs an RC 
controller with four channels. 
Robotistan recommends a 
RadioLink AT9 model RC controller 
(magpi.cc/2mh8gQ8). 

The drone comes with a KK2 
Multi-rotor LCD flight controller 
board (magpi.cc/2mhoCWa). 
The flight controller has GPIO 
pins, so it is possible to create 
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>STEP-01 


>STEP-03 


feature 


£180 
$239 


PIRATE RADIO [|6as 


magpi.cc/2nSEOfE 4 ‘iis eananaay 


This kit has everything you need to create a 
radio with your Raspberry Pi. Itcontains the # 
new Pi Zero W and a pHAT BEAT (DAC and 
stereo amplifier). You also get a5W speaker. 
The plastic case has a VU meter so you can 
view the sound levels. You will need to solder 
the GPIO header on to the Pi Zero W, anda 
female header to the pHAT BEAT. } " 


pi-top: £229.19 / $264.99 
PI = | Op pi-topCEED: £109.99 / $164.99 
pi-top.com 


The pi-top and pi-topCEED are 
projects to turn your Raspberry Pi into 
a laptop or desktop computer. Unlike 
a regular laptop or desktop, these are 
module DIY computers that are ideal 
for mobile making. You can 3D-print 
the case and buy the components, 
or get the whole lot in kit form. It’s 
not cheap, but it’s designed to 
teach the basic architecture of 

a computer, and there’s plenty of 
documentation and tutorials. 


magpi.cc/2nSMYVz 


Start your mini surveillance state with this 
sign that houses a Pi Zero and a Camera 
Module. The camera logo on the sign has a 
hole for the Camera Module. You need to 
buy the latter separately, but can combine 
it with OpenCV computer vision to create a sf 
smart CCTV Camera that recognises people. e000 ~ eeremeetenetse 
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MIROBOT V2 


magpi.cc/2nSJMto 


The Mirobot is a small, low-cost robot 
that you assemble using the packaging 
it comes in. Once you’ve built the 
robot, you add a felt-tip pen 
and use it to move and 
draw. The Mirobot acts 
like your average turtle 
robot. It can raise or lower 
the pen to draw shapes 
on paper. Turtle robots 
have a long history 


in computing and maker iQ 7 eal, 
culture, and they’re a great project for wy 


learning logic (and to see code in action). 


MEARM 


magpi.cc/2nSOIDo 


Not all robots have wheels. The MeArm is a flat-pack 
robot arm kit that you build. It can then be controlled 
via Python or directly with a joystick. It’s very easy to 
assemble, using just a screwdriver, and we think this 
is a great kit for anyone wanting to step into the world 
of digital making. 


“ts Gs 
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SUBSCRIBE TODAY AND RECEIVE A 


Subscribe in print for 12 
months today and receive: 


A free Pi Zero W (the latest model) 
Free Pi Zero W case with 3 covers 


raw 


Free Camera Module connector 
Free USB and HDMI converter cables 


’ 


Other benefits: 


Save up to 25% on the price 
Free delivery to your door 


Exclusive Pi offers and discounts 
Get every issue first (before stores) 


a azine 
; y Pi mag J 
al Raspberty ~ 

the official 5 


BUILD A DIGITAL MAKE AN 
WHOOPEE CUSHION |) ALEXA ROBOT 


j | aa eer 
GAMING 
BLISS -* 


eld gaming masterpiece 
prand new Raspberry Pi Zero W 
— 
BACK UP YOUR ADVANCED St 
RASPBERRY PI GPIO CONTROL 
Kaepipetd fies bo Inprove vou orclcta R 
P| ZERO NOW HAS 
a | 
a 


WIRELESS 


ges 
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» The original 


mm PIMINIMINT 


pweeeees § A fully functioning computer and display crammed into a mints tin 
NolR camera 

» Sugru stops the att Wagner first thought and the low availability of Zeros to a 2-inch LCD display and - 
charger port about fitting a computer made it challenging to find and thanks to a RedBear loT pHAT - 


movingiaround into an Altoids tin in use for anything at the time,” he equipped with WiFi and Bluetooth. 
» Hot glue is 2012, shortly after the launch of recalls. “However, !nowworkinan “The original design took a few 

eee fee the original Raspberry Pi. While it environment [Micro Center store] weeks, between prototyping 

points wasn’t quite possible back then, surrounded with DIY materials, and sourcing parts,” Matt tells 
OSHS Raw: the release of the considerably so the idea just came back to me us. “The concept of it is simple: 

model will smaller Pi Zero changed everything, one day.” strap together already available 

feature a although not immediately for Matt. The result is the PiMiniMint, components. In actuality, though, 


phone SIM 


“T was deep into another project, containing a Pi Zero connected sourcing parts was a bit of an issue 


» Planned 
Pi projects 
include smart . : . - 
luggage = aes — The 2-inch screen and 
tracking ~), j i moe , poke its board are taped to 
J to the lid of the tin 


The Pi Zero is soldered to 
an loT pHAT, both lying on 
top of the LiPo battery 


a 
a 
AAAs 


tty 
Lit seg 


The battery charging circuit 
is connected to the Pi via an - pi 
on/off switch / " Be it \ > By O07 A srcses a 


et 
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Rear solder pads on the Pi Zero are 
used to connect the charger and 
switch, and power wires for the screen 


(shipping costs, and buying pre- 
made parts gets very expensive), 
so I had to find creative ways to 
solve problems.” 

This included a solution for 
rechargeable battery power. “In 
my first iteration, I had no way 
to charge the battery,” explains 
Matt. “An Adafruit PowerBoost 
would have been ideal, as it puts 
out enough amperage, but the cost 
would have been tight for me. The 
[Pimoroni] Zero LiPo is amazing, 
and I am currently using it in an 
ongoing project of mine; however, 
it sits too high on the GPIO and 
wouldn’t allow for the lid to close 
with the screen inside.” 

In the end, at the suggestion of 
a co-worker, Matt opted to modify 
a standard USB phone charger, 
extracting its charging circuitry to 
use with a slimline LiPo battery. 
He also added an on/off switch. “I 
had some issues regarding wiring 
and power needs, but those were 
related to where in the circuitry 
I put my switch, and the kind 
of switch I used,” he reveals. 


“Changing to a bet 


ter switch did 


the trick.” Matt’s 2500mAh LiPo 
provides impressive battery life: 


“T haven’t done a f 
test and timed it, b 
on for six-plus hou 


ull 100%-0% 
ut I have had it 
rs ata time.” 


One drawback of using a built-in 
battery was that there was no longer 
room in the tin for the infrared 
camera and full-size exterior USB 
port featured in the original design. 
“However, I do still have an interior 
full-size USB [via an adapter] that is 
available when opened.” 

Matt is currently making a 
second PiMiniMint for a friend, 
featuring a few modifications: “His 
is going to have two on-board WiFi 
antennas and a dedicated SIM for 
transmitting data over 3G/4G.” 

As well as it being a cool pocket 
PC, Matt thinks the PiMiniMint is 
ideal for portable retro gaming. 
“Additionally, I have used it asa 
WiFi access point for saving files 
to, a WiFi repeater by plugging a 
second WiFi antenna into the USB 
port, and I’m sure there are more 
ideas out there!” 


Amazingly, 
everything 
fits into the 
60*95mm 
Altoids tin; 
there's even 
room fora 
USB adapter 


ay 


; 
17 
1 ae 
ia 
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» A five-minute 
film reel can 


produce 4,000 
still images 


» 8mm captures 
need a 25mm 
focal length 


magnifying lens 


» The projector 
uses a NEMA 
17 motor anda 
DRV8825 chip 


» Joe 3D-printed 
mounts for the 
lamp and motor 


» Ituses the 
original 5MP 
Camera 
Module 
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Placed inside the projector, the 
Raspberry Pi Camera Module records 
each image, one shot at a time 


The Raspberry Pi is used to capture the 
images from the projector and sends 
them to a client computer for processing 


Astepper motor (controlled by the 
Raspberry Pi) is used to advance 
the film reel one frame at a time 


CAPTURE 


Expertly converting old film reels to digital video one frame at a time 


estoring home movies 

captured on film can be 

areal challenge. Film 
conversion is a time-consuming 
and often expensive task. 

One maker, Joe Herman, took 
matters into his own hands by 
hooking up a Raspberry Pi Camera 
Module to an old projector. 

Joe’s cousin and uncle uncovered 
a box of 130 reels recorded by his 
grandfather. Leo’s moves “dated 
back to 1938,” says Joe. 

The preservation of these 
memories was important for Joe’s 
large extended family. But to have 
them professionally restored 
would have cost “many thousands 
of dollars.” 

The obvious approach with 
a project like this would be to 


run the movie and record it using 
a camcorder. The results from that 
approach are very poor, though. 

Professionals photograph one 
still image at a time and then stitch 
it all together, which is why the 
process is so expensive. 

Pi Film Capture is a smart 

film transfer system that uses a 
Raspberry Pi and Pi Camera Module 
with Bell & Howell 8mm and 

Super 8 projectors, or an Ampro 
Imperial 16mm. 

The setup employs a frame-by- 
frame approach. The Raspberry Pi 
takes a still photo of a film frame 
and sends it to a remote client 
computer for processing. 

The Raspberry Pi is connected 
to a stepper motor that moves 
the frame to the next cell. It then 


repeats the process until the 
entire reel is captured. “Most old 
projectors would work,” reckons 
Joe. “They were built to last.” 

Once the process is completed, 
the result is a folder of images. 

“T can combine these quickly into 
a viewable movie using FFmpeg 
(ffmpeg.org),” says Joe. Ifa 

more sophisticated clean-up is 
required, he uses a program called 
AviSynth (avisynth.nl). 

“A key design goal for me was 
to use easily obtainable parts,” 
reveals Joe. “Mostly because when 
I began the project, | was unsure 
whether it would go anywhere and 
didn’t want to invest too much in 
expensive equipment.” 

Joe solved “endless” challenges 
while designing Pi Film Capture. 
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BUILDING A CINE-CONVERTER 


>STEP-01 


“Most were due to my inexperience 
and ineptitude,” he tells us. “Or 
bad programming techniques.” 

The first proof-of-concept device 
drove the projector and triggered 
a capture as each frame advanced. 
“Tt fooled me into thinking this 
would be an easy project,” recalls 
Joe. But frames were often under- 
or over-exposed. Sometimes it 
would miss frames altogether. 

As Joe iterated through different 
versions of the project, he added 
a separate client computer: a PC 
running Ubuntu Linux. 

The client computer runs a 
control panel that lets the user 
adjust the camera, and displays 


Joe has captured over 100 reels 
of film recorded by his grandfather 
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i 
>STEP-02 


the captured frames as they come 
off the Raspberry Pi. It also sends 
some simple projector control 
commands to the Pi. 

The latest version of the Pi 
Film Projector uses OpenCV 
opencv.org). This software adds 
computer vision and multi-core 
processing to the project. 
“OpenCV provides functions 
similar to the HDR mode on cell 
phone cameras,” explains Joe. 
Given several photos at different 
exposures, it can blend them into a 
single image that preserves detail 
in both bright and dark areas. 

“For some films, this can make 
an enormous difference,” says Joe. 


= 


P| FILM CAPTURE 


>STEP-03 


“The downside is it slows down my 
captures by nearly half as I take 
more photos, so | try only to use 
it when necessary.” 

Joe advises prospective makers 
to have patience with the build. 


ice 


t has a lot of pieces,” he says. 
The captures take a lot of time, and 
getting good results can take a lot 
of practice. 
The results are worth it. Joe 


has converted ove 
grandfather’s reel 
some family histo 
and sharing it has 


most rewarding te 


ever worked on,” 


r 100 of his 

s. “Bringing 
ry to life again 
made this the 
ch project I’ve 
he tells us. “I 


hope it inspires other people to 


bring that old box 


of film cans out 


of the closet and reconnect with 


their history.” 


Projects 


Above As the 
project has 
progressed, the 
image editing 
software has 
become more 
advanced, creating 
higher-quality 
recordings 
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The capture is analysed and 
classified by Google TensorFlow, 
which lists the top five possibilities 
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OpenCV and TensorFlow 
are used for image 
capture and recognition 


» The flies can 
live for 30-40 
days 


» David says 
he'd intervene 
if needed 


» The work isn't 
anti-Al, just a 
“commentary” 


» Previous 
projects include 
tweeting flies 


» He's hoping to 
exhibit flyAl in 
the autumn 


PLY. 


The fate of the whole colony depends on a Raspberry Pi 


lies crawl around inside 

a transparent sphere, 

spied on by a camera, as a 
disembodied voice reads out image 
recognition data that determines 
whether or not they will be fed. 
This is the unsettling theme of flyAI 
(magpi.cc/2n7pijV), a Pi-powered 
art installation by David Bowen, 
who was inspired to create it after 
reading philosopher Nick Bostrom’s 
Superintelligence: Paths, Dangers, 
Strategies. The book explores the 
prospective effects of future super- 
intelligent AI on the human race 
and while there are some utopian 
possibilities, David says there are 
also dangers: “The AI could end up 
repurposing our atoms for food!” 


The camera takes a 
photo of any fly landing 
in its field of view 


If the top result is ‘fly’, sugar water 
is pumped into the chamber 


David tells us why he uses 
houseflies in some of his work: 
“They’re often a stand-in for 
the absurd or, thinking about 
collective behaviour, the will of the 
collective,” although their actions 
aren’t quite as random as you 
might expect: “They do like to work 
their way to the tops of containers; 
they’ re attracted to light. 

“Also, they don’t elicit as much 

empathy from viewers as another 

living creature,” adds David. That’s 
probably just as well given the 
nature of flyAI, in which the flies 
survival depends on the accuracy 
of image recognition. A regular 
USB webcam positioned at the top 
of the custom-built fly chamber is 


) 
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FLYAl Projects 


connected to a Raspberry Pi 3 which reveals that the survival rate is good: 


employs OpenCV to determine “They live for about 30-40 days, 
when a fly is in view and take a which I’m told is longer than they 
still. The photo is then classified live in the wild... they were getting 
by the Google TensorFlow image kind of geriatric!” This is despite 
recognition algorithm which ranks them interfering with the image 
the top five possibilities in order, recognition in a certain way: “The 
along with their percentages. The flies poop all over the inside of the 
results are revealed gradually on an sphere, including where the camera 
LCD screen, as if being typed, and is.” While David obtains his flies 
also read out aloud using the Festival from an online source, he thinks 
text-to-speech system. they could possibly reproduce within 


The flies are a stand-in for the 
absurd or, thinking about collective 
behaviour, the will of the collective 


If ‘fly is ranked number one by the chamber if given the right 
the algorithm — which happens conditions to lay their eggs. 
around 60% of the time according Looking to add further elements 
to David - the flies are given some to the project, David is exploring 
food. “So their fate is determined the possibility of using the fly 
by how accurate this Al is.” The corpses to provide material for a 
feeding process is also controlled by — microbial fuel cell that he’s working 
the Pi, which triggers arelay tostart on, which in turn will power the 
a pump to supply sugar water from Raspberry Pi. He would also like to 
a bucket, up through tubes into the implement machine learning so that 
middle of the chamber. the image recognition gets smarter, 
Having run the experiment for “so the two [Pi and flies] could be 
six weeks in his workshop, David more interdependent.” 


MAKE A FLY MACHINE 


o— . ~~ 


>STEP-02 


>STEP-03 


raspberrypi.org/magpi April2017 MagPi | 33 


The basic commands you need to get advice from the Linux command line 


Many commands 
feature a built- 
in help option, 


s name accessed with -h 
ia pet aaacl ‘gies oT Hae pa or --help. Using it 
created utrw. and direc S utrwx, minus s i offers a brief outline 


directory 
--dry-run 


Don’t let your Raspberry Pi suffer from a shortage of volts 


The Raspberry Pi 
Universal Power Supply 
is a reliable source of 
power for your board 


Boot 


Idle 


Max 0.26A 
Avg 0.22A 
Avg 0.20A 


Video playback (H.264) Max 0.30A 


Raspberry Pi Model A 
Raspberry Pi Model B 
Raspberry Pi Model A+ 
Raspberry Pi Model B+ 
Raspberry Pi 2 Model B 
Raspberry Pi 3 Model B 


70omA 
1.2A 
7o0omA 
1.8A 
1.8A 


2.5A 


Stress 


500mA 
500mA 
500mA 
600mA/1.2A (switchable) 
600mA/1.2A (switchable) 


1.2A 


Avg 0.22A 
Max 0.35A 
Avg 0.32A 


0.40A 
0.22A 
0.22A 
0.36A 
0.28A 
0.82A 
0.75A 


0.75A 
0.35A 
0.3a0A 
0.55A 
0.33A 
1.34A 
0.85A 


0.20A 
0.15A 
0.10A 
0.23A 
0.16A 
0.35A 
0.23A 


Test conditions used a standard Raspbian image (26 Feb 2016), at room 
temperature, connected to an HDMI monitor, USB keyboard, and mouse. 
For the Model 3B it was connected to a WiFi access point. All these power 
measurements do not take into account power consumption from additional 
USB devices; these measurements can easily be exceeded with multiple 
additional USB devices connected or when using a HAT. 


Tutorial STEP BY STEP 


CREATE AN LED 
THERMOMETER 


Read a temperature sensor and display its value as a bar graph 


GPIO Zero 
Python library 


1x solderless 
breadboard 


1x MCP3008 
ADC chip 


1x TMP36 
temperature 
sensor 


5x LEDs (red, 
yellow, green) 


5x 3302 resistors 


1x 1uF capacitor 


11x male-to- 
female jumper 
wires 


8x male-to-male 
jumper wires 
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nalogue readings on the Pi require an 
analogue-to-digital converter (ADC) chip such 
as the MCP3008. It’s a pretty popular ADC, so 
like many other things you’ ll find it in the GPIO Zero 
Python library. We’ll use one to display the current 
temperature on the screen, then add some LEDs and 
use GPIO Zero’s handy LEDBarGraph class to get them 
to light up according to the temperature. 


>STEP-01 

Enable SPI 

The analogue values from the ADC chip will be 
communicated to the Pi using the SPI protocol. While 
this will work in GPIO Zero out of the box, you may get 
better results if you enable full SPI support. Opena 
terminal window and enter: 


sudo apt-get install python3-spidev 
python-spidev 


Click OK and reboot the Pi. 


McP3008 


>STEP-02 

Connect the ADC 

It’s best practice to turn off the Pi while creating 
our circuit. As you can see from the diagram below, 
there’s quite a lot of wiring required to connect the 
MCP3008 ADC to the Pi’s GPIO pins. 

First, place the MCP3008 in the middle of the 
breadboard, straddling its central groove. Now 
connect the jumper wires as in the diagram. Two go to 
the ‘+’ power rail, connected to a 3V3 pin; two others 
are connected to a GND pin via the ‘—’ rail. The four 
middle legs of the ADC are connected to GPIO pins 8 
(CEO), 10 (MOST), 9 (MISO), and 11 (SCLK). 


>STEP-03 

Add the sensor 

Now that the ADC is connected to the Pi, you can wire 
devices up to its eight input channels, numbered 0 to 
7. Here, we’ll connect a TMP36 analogue temperature 
sensor. It’s vital that this is wired up correctly, 
otherwise it’ll overheat. With its flat face towards 


It's vital to get the wiring correct 
for the TMP36 sensor, otherwise 
it will quickly overheat 


Link the sensor's ground and 
output pins with a capacitor to 
help stabilise its readings 


The MCP3008 ADC chip straddles 
the central groove; the side 
shown without wires comprises 
eight input channels 


We use five LEDs to display 

a bar graph relating to the 
temperature; each LED is 
connected to a different GPIO pin 


Each LED's shorter leg is 
connected to the ground rail via 
a resistor, to limit the current 
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you, the left-hand leg is for power, so connect this to 
the ‘+’ power rail. The right-hand leg is connected to 
the ‘—’ ground rail. Its middle leg is the output; here 
we’re connecting to channel 7 (the nearest one) of the 
MCP3008. Finally, to help stabilise the readings which 
might otherwise be erratic, we’ll add a capacitor to 
link its output and ground legs. 


>STEP-04 

Take the temperature 

We can now read the sensor’s value in Python. On the Pi, 
open IDLE from the main menu: Menu > Programming 
> Python 3 (IDLE). Create a new file, enter the code 
from chi1olisting1.py, and save it. At the top, import 
the MCP3@@8 class from GPIO Zero, then the sleep 
function from the time library. Next, we define a 
function that converts the sensor reading into degrees 
Celsius. We then assign the adc variable to channel 7 of 
the MCP3008. Finally, we use a for loop to display the 
converted temperature on the screen, updating it every 
second. Note: if you’ve just been handling the sensor, 

it might take a little while to settle down. 


>STEP-05 

LED bar graph 

Next, we’ll add our line of five LEDs to the circuit, as 

in the diagram. From green to red, we’ve connected 
their longer legs to the following GPIO pins: 26, 19, 13, 
6, and 5. In IDLE, create a new file, enter the code from 
chiolisting2.py , and save it. At the start, we import 
the LEDBarGraph class from GPIO Zero; this will enable 
us to use the LEDs to display a bar graph, saving a lot 
of complex coding. We assign the graph variable to our 
LEDs on the GPIO pins mentioned previously, and also 
enable PWM so that we can adjust their brightness for 
a 
Vv 


more accurate display. We then set graph. value to 
arious fractions between 0 and 1 to light the relevant 
number of LEDs from green to red, including partially 
lit ones for precision. Note that if the value is negative, 
it will light the LEDs from the other end, red ones first. 


>STEP-06 

Display the temperature 

So, we’ve got our temperature sensor and LED bar 
graph set up. Let’s combine them to display the 
temperature on the LED bar graph. In IDLE, create a 
new file, enter the code from chiolisting 3.py, and 
save it. At the top, we import GPIO Zero’s MCP3008 
and LEDBarGraph classes, along with the sleep 
function from the time library. We then define a 
function to convert the temperature sensor’s readings 
to degrees Celsius. We assign the adc variable to 
channel 7 of the MCP3008 and graph to our LEDs’ 
GPIO pins, setting PWM to true. Finally, in our for 
loop, we add a bars variable to determine how many 
LEDs are lit in the bar graph. In this example, we’ve 
ivided temp by 35, which is around the maximum 
temperature for the UK, so if it gets to 35°C, all the 


fay 


raspberrypi.org/magpi 


L 
a 
Cc 
L 


CREATE AN LED THERMOMETER 


ch] Olisting! py 


from gpiozero import MCP3008 
from time import sleep 


def convert_temp(gen): 


>PYTHON 3 


DOWNLOAD: 
magpi.cc/2bhwQ@bJ 


for value in gen: 
yield (value * 3.3 - 0.5) * 100 


adc = MCP30@8(channel=7) 


for temp in convert_temp(adc.values): 
print("The temperature is", temp, "C") 


sleep(1) 


chi Olisting2.py 


from gpiozero import LEDBarGraph 
from time import sleep 


graph = LEDBarGraph (26, 19, 13, 6, 5, pwm=True) 


graph.value 
sleep(1) 
graph.value 
sleep(1) 
graph.value 
sleep(1) 
graph.value 
sleep(1) 
graph.value 
sleep(1) 
graph.value 


1/10 


3/10 


-3/10 


9/10 


95/100 


() 


chi Olisting3.py 


from gpiozero import MCP3008, LEDBarGraph 
from time import sleep 


def convert_temp(gen): 
for value in gen: 
yield (value * 3.3 - @.5) * 100 


adc = MCP3008(channel=7) 
graph = LEDBarGraph (26, 19, 13, 6, 5, pwm=True) 


for temp in convert_temp(adc.values): 
bars = temp / 35 
graph.value = bars 


sleep(1) 


EDs should light up fully. Naturally, you can 
djust this number to suit your own location’s 
imate. When ready, run the code and see those 
EDs light up to show the current temperature. 


April2017 MagPi | 41 


Tutorial 


AN INTRODUCTION TO C 
FILE INPUT AND OUTPUT 


READ AND 
WRITE THE 
SAME FILE 


You can open 
a file for 
simultaneous 
reading and 
writing with the 
same pointer. 
Set the file 
access mode 
to rb+ to read 
an existing 

file and to 
overwrite it; 
set it to wb+ to 
create a new 
file and be able 
to read back 
what you have 
written to it; 
set it to ab+ to 
open a file to 
both append 
at the end and 
read from it. 


CHECK THE 
LIBRARY 


The C library 
offers a wide 
range of 
functions for 
reading and 
writing data 
from and to 
files; we've just 
looked at some 
of them. If you 
need to access 
a file, have a 
look at some of 
the other library 
functions - like 
fread, fwrite, 
fscanf, fputs, 
and fgets - 

to see if they 
are more 
appropriate 
than the basic 
fputc and 
fgetc we've 
used here. 
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Reading from and writing to files 


n last issue’s tutorial, we looked at how 

to get input from the user at the console. 
In this instalment, we’ll look at the other 
common method of input and output in C; reading 
and writing files. 

Many programs need to be able to access files on 
the computer’s disk. 

In C, files are accessed by use of file pointers, which 
contain all the information required to access a file — its 
name and location on the disk, and a current position 
within the file at which data will be read or written. 

So the first thing we need to do is to get a file pointer. 
This is done using the C function fopen, which takes two 
arguments. The first argument is the path to the file; the 
second is the file access mode — this indicates whether you 
intend to read from the file or write to it. 

Here’s an example of reading a file. Use your text 
editor to create a file called input.txt in the /home/pi 
directory, and type anything you like into it. Save it, and 
then create and run the following program: 


#include <stdio.h> 


void main (void) 
{ 

FILE *fp; 

int value; 


fp = fopen ("/home/pi/input.txt", "rb"); 
if (fp) 
{ 
while (1) 
{ 
value = fgetc (fp); 
if (value == EOF) break; 
else printf ("%c", value); 
} 
fclose (fp); 
} 
} 


We create a file pointer using the command 
fopen (short for ‘file open’) — we open the file at 


Inputted text is read from a special 
text file created for the task 


>= me (4) [MM pi@raspbenypi-~ | «iv linput tt - home/pi - 


> | filein.e * | input txt 
1 This is some text in 

2 a test file for the file 
input program... 


3 
4 


pi@raspberypr ~ 


09:42:55: Fi 


Compiler) o9.44:33: File fh saved. 


Vv 0914414 le *untitled* opened 


line 4/4 _cokQ _sel:0 INS __TAB 


The information from the text file can then 
be read from the script, as well as changed 


/home/pi/input.txt, with the mode rb, for ‘read 
binary’. This creates the file pointer and initialises it 
to the beginning of the file. 

We then check to see if the file pointer is non-zero 
— if the pointer is returned as zero, the file wasn’t 
successfully opened. (For a read, this usually indicates 
that the file doesn’t exist.) 

We then repeatedly call the function fgetc (for ‘file 
get character’) — each time this function is called, it 
reads a single byte from the file, and then advances 
the file pointer to the next byte. When the file pointer 
reaches the end of the file, it returns the special value 
EOF (‘end of file’). So we print the value returned by 
fgetc each time until it returns EOF. 

Once we have finished reading the file, we stop 
access to it by calling fclose (for ‘file close’). 

Note that while fgetc reads characters, it returns 
an integer — this is because the code for EOF falls 
outside the valid range of a char variable (0-255). 
Unless at end of file, fgetc returns an integer value 
which can be treated as a char. 
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Writing a file 
To write to a file, we use a file pointer in exactly the 
same way, but we open it in a mode for writing. 


#include <stdio.h> 


void main (void) 
{ 

FILE *fp; 

int value; 


fp = fopen ("/home/pi/output.txt", "wb"); 


if (fp) 
{ 


for (value = 48; value < 58; value++) 


{ 
fputc (value, fp); 


} 
fclose (fp); 


} 
} 


We open the file /home/pi/output.txt with the 


mode wb, for ‘write binary’. We then call the function 


fputc (for ‘file put character’) in a loop, writing the 
bytes 48, 49...57 to the file. (These are the character 
codes for the digits 0, 1...9). We then close the 
file pointer. 

After running this, you should find the file 
output.txt in your home directory, containing the 
string "@123456789". 


Formatted output 

fputc is useful for writing bytes to a file, but it’s an 
inconvenient way of writing text to a file. For this, 
we can use the fprintf function (short for ‘file 
print formatted’). 


#include <stdio.h> 


void main (void) 


{ 
FILE *fp; 
fp = fopen ("/home/pi/output.txt", "wb"); 
if (fp) 
{ 
fprintf (fp, "This is some text.\n"); 
fclose (fp); 
} 
} 


fprintf works in exactly the same way as sprintf, 


but the first argument is a file pointer rather 
than a string. 
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AN INTRODUCTION TO C 


Above Example code and how it should look on Raspberry Pi 


Moving around a file 
To add to the end of an existing file, open it with 
the mode ab (for ‘append binary’). If the file exists, 
output will then be added to the end of the file; if the 
file does not exist, it will be created and output will start 
at the beginning. 

Sometimes when accessing a file, we don’t want 
to start at the beginning. The fseek function is used 
for this. 


#include <stdio.h> 


void main (void) 
{ 

FILE *fp; 

int value; 


fp = fopen ("/home/pi/input.txt", "rb"); 
if (fp) 


{ 
fseek (fp, 10, SEEK_CUR); 
while (1) 
{ 
value = fgetc (fp); 
if (value == EOF) break; 
else printf ("%c", value); 
} 
fclose (fp); 
} 


} 


fseek (fp, 10, SEEK_CUR) moves the file 
pointer 10 bytes ahead of the current position, so 
this program will print all but the first ten characters 
in the file. The first argument to fseek is the file 
pointer; the second is how many bytes to move 
the pointer. This can be positive or negative — so 
fseek (fp, -5, SEEK_CUR) moves the pointer 5 
bytes back from the current position. 

The third argument to fseek allows you to choose a 
position relative to the start of the file (SEEK_SET) or 
the end of the file (SEEK_END) rather than the current 
position (SEEK_CUR). 


Tutorial 


REMEMBER 
TO FCLOSE 


It's easy to 
forget to call 
fclose on 
your file, but it 
is important to 
do so. On some 
systems, when 
writing to the 
file system, 
the write 
doesnt actually 
complete 
until fclose 

is called — if 
your program 
doesnt call 
fclose, you 
might find 

that you write 
to files and 
nothing shows 
up in them. 


ALWAYS 
CHECK YOUR 
FILE POINTER 


Never assume 
that fopen 
has worked - 
always check 
that the value 
it returns is a 
valid pointer 
(ie. not zero). If 
you try to read 
from a zero 
pointer, you'll 
get random 
nonsense; if 
you write toa 
zero pointer, 
you'll probably 
crash the 
system! 
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BUILD A 
REACTION GAME 


Make a fast-paced reaction game and challenge your friends to find out 
who has the best ninja reflexes! 


2x red LEDs 


RGB LED 


2x Tactile 
push buttons 


5x 470Q resistors 


8x Male-to- 
female jumper 
wires 


>STEP-01 
Connect the LEDs 
Gather the components as listed on the left. Following 


sing a breadboard and some simple 
components, make a super-fun reaction game 


4x Male-to-male while learning how to use a breadboard to 


jumper wires 


Alternatively, 
Monk Makes 
Raspberry Pi 
Electronics 
Starter Kit 
magpi.cc/ 
2lWIZHp 


make an electronic circuit, as well as programming 

in Python to make your game even better! The game 
involves a race against an opponent, but there area 
handful of trick signals thrown in for good measure, 


so don’t get too complacent. The project is designed as 


an extension to the projects found in the Monk Makes 
Raspberry Pi Electronics Starter Kit. 


Above It's a simple circuit, but you could easily turn it into 
a physical game with some 3D-printed parts 
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the breadboard diagram, attach the two red LEDs to 
the breadboard, at either end. You must ensure that 
the long leg of the LED is facing down, on both LEDs. 
This is the positive leg, which will be connected to a 
positive output on the Raspberry Pi. The big RGB LED 
can be connected in the middle of the breadboard, 
on the right-hand side, as shown. There is one leg 
longer than the rest, which will be connected to the 
second hole from the top (shown by a red circle on 
the diagram). This is the negative leg. 


>STEP-02 

Add the resistors 

In order for the LEDs to work correctly, a resistor 
needs to be added in series to each one, limiting the 
flow of current so they don’t melt! You will need five 
resistors, as the RGB LED counts as three separate 
LEDs that share the same cathode (negative leg). 
Connect three resistors to the LED’s positive legs, 
bridging the gap across the centre of the breadboard, 
as shown in the diagram. All of the pins in each row 
are connected to each other inside the breadboard, 
with a gap in the centre. 
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BUILD A REACTION GAME | Tutorial 


qanguage 


>PYTHON 


6 OBES Eepeastena- 


CODE NAME: 


02_reaction_game.py 


DOWNLOAD: 
magpi.cc/2nlWsTe 


Above Current scores are displayed in the terminal 
window on the Raspberry Pi 


>STEP-03 

Add the buttons 

This project needs two buttons: one for each player. 
Some small buttons have four legs, as shown in the 
diagram, and a connection is made between the 
diagonal pins when it is pressed. If you have a button 
with two legs, simply connect it to the breadboard 
with one leg on either side of the central gap, ensuring 
that the jumper wires are connected to the same row 
as the button. As you can see from the diagram, the 
button will be connecting a Raspberry Pi input pin to 
ground when pressed. 


>STEP-04 

Finish up 

Using the five male-to-male jumper leads, follow 
the diagram to connect all the negative legs on the 
LEDs and the buttons together, which can then be 
connected to a ground pin on the Raspberry Pi. The 
eight male-to-female jumper leads can then be used 
to connect the positive sides of the LEDs to the Pi’s 
output pins, as wellas connecting the two buttons Above For a tidy breadboard, trim the legs of the components 
and the common ground connection. Ensure that and jumper wires so that they sit neatly on the surface 

each jumper lead is connected to the correct pin on 

the Raspberry Pi, as this is crucial for the code to run >STE P-06 


correctly with the hardware. How to play 

When you run the program, you will first need to 
>STE P-05 type the names of the two players. Player one’s 
Install the code button is located at the bottom of the breadboard 
Using the latest version of Raspbian (PIXEL) on and player two’s at the top (as shown on the 
your Raspberry Pi, you can now boot up. If you diagram). Whenever the RGB LED in the centre of 
are not using this version of Raspbian, you will the breadboard lights up in any colour other than 
need to install the GPIO Zero library if you haven’t red, press your button as fast as you can. The first 
already. You’ll need to make sure that your Pi is player to hit their button will gain a point. However, 
connected to the internet, via WiFi or Ethernet. beware! If the RGB LED lights up in red, do not press 
When booted, open the terminal window and type: your button. If you do, one point will be deducted 
git clone https://github.com/henrybudden/ from your score! After each round, the score for each 
rpesk-advanced/. This will download the Python player is displayed on the screen, and one of the 
files from GitHub, onto your Raspberry Pi. Once this small red LEDs on the breadboard will light up on the 
is completed, you can navigate to the folder using side of the player in the lead. If both LEDs are lit up, 
cd repsk-advanced and then run the game by you are tied. Each round will begin automatically, 
typing sudo python @2_reaction_game.py. so keep going until you get too tired! 
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Tutorial WALKTHROUGH 


CREATE A 
MONOPOLY 
SIMULATION 


Hack the board game of Monopoly by figuring out which properties are best to buy. 
This tutorial simulates a game and figures out the winning squares 


onopoly is a great board game that can be the Welcome to the world of ‘discrete event 
subject of many arguments. After playing the simulations’. These are used to model all sorts of 
game for a long time, players seem to land on effects, from when trains arrive to particle collisions 


some board squares more than others. Some people at the highest energies. 
seem to favour the second street (light blue), while The simulations are constructed from an 
Reser) others choose the fourth (orange). Therefore, to settle | understanding of the expected probability 
Raspbian these arguments, a simple discrete event simulation distributions. These are combined together to 
Matplotlib can be built that describes the game and predicts form the final event. In the case of trains, the train 
where the players will land on average. In this series, timetable and the distribution of arrival times can 
the simulation will be built from simple components be used as an input probability distribution. For 
into a complex model of the board that predicts the particle physics simulations, the initial probability 
probability of where players will land. distributions are taken from theoretical models. 


In the case of our Monopoly game, the random 
| elements are the dice and the order of the cards in the 
Chance and Community Chest decks. Once you’ve got 
these, you can play games of Monopoly and discover 
which squares are landed on the most. Armed with 
this info you can be sure to buy these squares, and 
improve your chance of winning a game. 
In this article, a simple simulation of just the board 
and the dice is introduced. The first building block in 
this is the simulation of rolling two dice. 


e The chart currently shows the probability 
of landing on each of the Monopoly board 
squares, where no additional effects (like 
Go To Jail) have been added. We start with 
everything even 


° The vertical bars are the probability of landing 
on a Monopoly board square 


* The 40 bars are the Monopoly board squares, 


a oO] Gy +| Fai aw from ‘GO’ (0) to the last square (39) 
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Rolling the dice 

Players move around a Monopoly board by throwing 
two dice. An ideal six-sided die has the same 
probability of landing on each side. Therefore, 

the probability of throwing any of the numbers 

is the same: 


P(1) = P(2) = P(3) = P(4) = P(5) = P(6) 


The total probability for all allowed states is defined 
as one. Therefore, each of the sides of the die has a 
probability of 1/6 of being selected. 

In the Monopoly board game, two dice are rolled 
rather than one. The probably of throwing a total 
value on two dice is not the same for the all of the 
possible total values, since there is more than one way 
of producing some of the outcomes. The probability of 
rolling a total of twelve is: 


P{6,6} = P(6) x P(6) = 1/36 


...since there is only one way to create this total value. 
However, the probability of rolling a total value of five 
is the sum of the probability for each combination: 


P{2,3} + P{3,2} + P{1,4} + P{4,1} = 4/36 = 1/9 


Simulating two dice 

The effect of throwing a perfect six-sided die can be 
simulated by using a random number generator to 
generate integers between one and six. The Python 
random library provides a function, randint, that 
allows integers to be generated between two limits. 
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CREATE A MONOPOLY SIMULATION 


Tutorial 


twoDice.py 


Import the random package 
import random 


>PYTHON 


DOWNLOAD: 
github.com/wil- 
liamhbell/ Monop- 
olySimulation 


def rollTwoDice(): 
# Generate two random numbers within the 
# range 1 <= i <= 6 and add them together 
return random.randint(1,6) + random.randint(1,6) 


# A list to contain the total value rolled. 
# There are 12 elements, because total value you can roll is 12. 
counters=[@. ]*12 


# Roll two dice 100 times. 

nRolls = 100 

for i in range(nRolls): 
totalValue = rollTwoDice() 


roll the dice 


# Python list indices count from zero. Therefore, have to remove 

# one from the totalValue to put it into the right index in the list. 
# count this total value 

counters[totalValue-1] = counters[totalValue-1] + 1. 


# Total probability is always defined as 1. 
# Therefore, have to divide by the total number of counted values. 
for i in range(len(counters) ): 

counters[i] = counters[i] / float(nRolls) 


# Now print out the probabilities for each of the combinations 
print("The probabilities of rolling a total value using two dice:") 
for i in range(len(counters)): 

# Need to add one, since Python counts from zero. 

print(" P("“+str(it+1)+")="+str(counters[i])) 
print( 
"where P(n) is the probability of rolling a total of n on two dice.") 
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The standard random number generator that is 
packaged with Python is not perfectly random, but 
is sufficiently random to be used for this project. It 
generates numbers from a random series, which is 
initialised from a random number seed. If the seed is 
not set within the program, then a different seed is 
chosen each time the Python program that uses the 
library starts. 

Rolling two dice can be simulated by running 
the randint function twice and adding the result 
together, where each randint function call produces 
an independent value. 

The twoDice.py program simulates rolling two dice 
100 times. The program contains a simple function 
called rollTwoDice that calls the randint function 
twice, adds the return values together and returns the 
result. When the program starts, it creates a list called 
counters. This list has twelve elements set to zero. 

A floating point value is used in this list, since the 
final probability values are floating point numbers. 
Once the list has been created, the program goes into 
a loop calling rol1TwoDice and recording the values 
returned in the counters list. Once the simulated 
dice have been rolled 100 times, all of the counter 
values are divided by the number of dice rolls. This 
creates a probability distribution function for a total 
value on two dice. 

Try running the twoDice.py program by typing: 


. /twoDice. py 


15 


20 


Then use a text editor, such as IDLE, to increase the 
value of nRolls by a factor of 100 or 1000 and rerun 
the program. As the number of rolls becomes very 
large, the probability distribution function reported 
by the program approaches the theoretical probability 
values for the different results of rolling two dice. 

The difference between the theoretical probability 
values and the observed probability values occurs due 
to statistical uncertainties. As the number of rolls 
increases, the statistical uncertainty on the resulting 
probability distribution function drops. 


Modelling the board 

The Monopoly board has 40 squares. A player starts 
from the ‘GO’ square and then moves around the 
board in a clockwise direction until the game finishes. 
Each of these squares can be given a number from 
zero to 39, where the ‘GO’ square is zero and the last 
square on the board is 39. As with the twoDice.py 
program, the number of times each square is chosen 
can be counted using a Python list with 40 elements. 
The only other information that is needed is the 
current player position. 

A simulation of the Monopoly board without any 
other effects is given in the boardOnly.py program. 
This program includes the rollTwoDice function, 
as well as a function called plot. The latter uses the 
pyplot functions bar and show to produce a bar chart 
that is shown on the screen. The pyplot function 
is part of Matplotlib. Therefore, before running this 
program, the Matplotlib library must be installed. 


25 30 35 40 
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sudo apt-get install python-matplotlib 


The program starts by initialising a Python list called 
counters with 40 elements that all contain zero. The 
values are set to be floating points, since the values 
will be divided by the total number of entries at the end 
of the program. The number of dice rolls is set to be 
1,000,000, so that the entries in the resulting probability 
distribution function have a low statistical uncertainty. 
The current position is set to be zero, which corresponds 
to the ‘GO’ square, then the program loops until the 
number of dice rolls has been achieved. 

Each time the program loops, the rollTwoDice 
function is used to create a new total value. The total 
value from the two simulated dice rolls is then added to 
the current position. If the new position is beyond the 
39th square, the total number of squares is removed so 
that the new position is still on the board. Then the new 
position is recorded in the counters list. 
After the player has gone around the board a few 
times, the frequency distribution recorded in the 
counters list approaches the theoretical distribution. 
The final frequency distribution is then divided by 
the total number of moves recorded to form the 
probability distribution function for the board. Rather 
than just printing out the different probability values, 
they can also be shown as a histogram using the 
Matplothb library. This is achieved by calling the plot 
function. The resulting plot stays on the screen until 
the associated window is closed. 

Try running the boardOnly.py program by typing: 


-/boardOnly. py 


The simulation takes several seconds to run, since 
it is set to run a large number of dice rolls by default. 
When it finishes, the Matplotlib window will appear, 
with the histogram of the different probability states. 
To make the program as simple as possible, the plot is 
not labelled. However, the x-axis label of ‘Monopoly 
board square’ and the y-axis label of ‘P(square)’ can 
be set by calling other Matplotlib functions. 

The probability distribution generated by running 
the boardOnly.py program is not flat because of 
statistical uncertainty on each counter value. As the 
number of rolls becomes bigger, the distribution 
becomes flatter. 
The boardOnly.py program produces a basic 
probability distribution function shape that will no 
longer be flat when the other effects of the Monopoly 
board game are added. 
In next issue’s article, the most important effect 
in the Monopoly board game will be added. Then 
other features will be added towards the complexity 
of the full game. As with all complex simulations, 
this will allow each of the effects to be observed and 
quantified. By the end of the series, it will be clear 
which properties should be bought to win the game. 
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boardOnly.py 


# Import the random package 
import random 


>PYTHON 


DOWNLOAD: 
github.com/wil- 
liamhbell/Monop- 
olySimulation 


# Import the matplotlib pyplot package 
import matplotlib.pyplot as pyplot 


def rollTwoDice(): 
# Generate two random numbers within the range 
# 1 <= i <= 6 and add them together 
return random.randint(1,6) + random.randint(1,6) 


# A function to create a histogram 
def plot(x, y): 

pyplot.bar(x, y) 

pyplot.show() 


# The number of squares on the board 
nsquares = 40 


# A list to contain the total value rolled. 
counters=[@. ]*nsquares 


# A variable to hold the current position 
currentPosition = 0 


# Set the number of rolls 
nRolls = 109090000 


# Print a message 
print("Rolling two dice 


+ str(nRolls) + " times...") 


# Roll the dice 

for i in range(nRolls): 
# roll the dice 
totalValue = rollTwoDice() 


# Move the player to the next position 
currentPosition = currentPosition + totalValue 


# If the player has moved past last square, wrap board around. 
if currentPosition >= nsquares: 
currentPosition = currentPosition - nsquares 


# Count the current position on the board 
counters[currentPosition] = counters[currentPosition] + 1. 


# Total probability is always defined as 1. 

# Therefore, have to divide by the total number of counted values. 
for i in range(len(counters)): 

counters[i] = counters[i] / float(nRolls) 


# Now print out the probabilities for each of the combinations 
print("The probabilities of landing on a given Monopoly square 
after " + str(nRolls) + " rolls") 
for i in range(len(counters)): 
Need to add one, since Python counts from zero. 

print(" P("+str(i)+")="+str(counters[i])) 
print("where P(n) is the probability of landing on the nth Monopoly 
board square") 


# Create a bar chart display 
plot(range(len(counters) ), counters) 
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PATRICIO GONZALEZ VIVO 


Artist and graphic engineer, and author 
of The Book of Shaders, Patricio uses 
the language of light to turn data into 
stunning landscapes. He believes in 
developing a better together. 
patriciogonzalezvivo.com 

@patriciogv 


Here's a GLSL shader mod running 
on Minecraft - a big difference from 
normal Minecraft! 


THE COMPUTER LANGUAGE OF LIGHT 


for your video games and projects 


ince the 1960s, computers have had graphic 

interfaces: mouse pointers, windows, icons, 

sidebars, all the things that are now common 
on home PCs. It hasn’t been until the last few decades 
that video games have pushed the limits of visual 
content on the computer. Video games have reshaped 
the computer from the inside out, and one particular 
piece of hardware is responsible for the leap: the 
graphics processing unit (GPU). Thanks to the GPU, 
you can enjoy realistic 3D worlds with incredible 
cinematographic effects on them. GPUs can be 
programmed, too: the small pieces of code that run on 
them are called ‘shaders’. An example of this is the GLSL 
Shaders mod pack for Minecraft (magpi.cc/2ikJsEN). 

Shaders are a dry, C-like computer language designed 

with the main purpose of rendering an image pixel by 


— 


File Edit Tabs Help 


> glslViewer 


magpi.cc/ 
2hNP4r3 


> The Book of 
Shaders 
magpi.cc/ 
2nJ5dR2 


The GPU is like a lot of smaller 
tubes that run in parallel 
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Make state-of-the-art special visual effects and animations 


pixel without sacrificing performance. We can think of 
shaders as the computer language of light. 

So how do shaders work? And how are they different 
from other computer languages? Graphics are quite 
hard for regular computer programs to process. Regular 
programs are written to be run on the CPU; they are 
designed to do one task after the other - like Python, 
for example, where the program follows a list of orders, 
one line at a time. 

Processing a digital image requires assigning a 
colour to each pixel on the screen. Let’s say you have 
an old 800x600 monitor: that requires around 480,000 
calculations. Now let’s say your image is actually an 
animation that needs to change 24 times per second 
to produce the illusion of movement. That is more 
than 11,520,000 calculations per second - enough 
calculations to freeze a CPU. 


A better solution 

That’s why engineers came up with a different way 

to process graphics on computers: they call it a GPU. 
You’ve probably heard it described as ‘the graphics 
card’. The main design difference is parallelization. 
The chip inside the GPU runs multiple tasks in parallel 
at the same time, each one independent from the 
others. In the first chapter of The Book of Shaders 
(thebookofshaders.com), you can find a more detailed 
explanation of this. 

Learning how to program your own shaders 

is not simple, but it doesn’t need to be hard any 
more! You can find a program called glslViewer 
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(magpi.cc/2hNP413) on the latest Raspbian 
distribution. This little program is made to view 
shaders and follow the examples in The Book of 
Shaders. This gentle step-by-step guide will walk 
you through learning about this abstract language 
of light. You can print a version of the book by 
following the instructions in this appendix chapter: 
magpi.cc/2iwOwWW. You will need a web browser 
with WebGL to both view and print the book. 


Live coding with glslViewer 
Running directly from the command line, glslViewer 
is a flexible renderer for shaders that doesn’t require a 
windows manager. 
To live-code a shader, you just need a text editor to 
do the coding and glslViewer will display the changes 
immediately. Let’s try it out! 
Open a Terminal window and install glslViewer: 


sudo apt-get install glslviewer 


Next, open a new file call shader.frag in your 
favourite editor (like gedit, nano, vi, or Emacs): 


nano shader. frag 
...and write in the following code: 


#ifdef GL_ES 
precision mediump float; 
#endif 


void main() { 
gl_FragColor = vec4(1.0,0.0,1.0,1.0); 


} 


Save the file, exit the editor, and give it a try 
on glslViewer: 


glslViewer shader.frag -1 
You should see a magenta rectangle at the top- 
left corner of your screen. It’s not much, just a 


starting point. 


Note: the -1 is to open it in live-code mode; this will 
open it not in full-screen, so you can keep editing 


it. You can also change the position and size of the 
viewport by using -x, -y, -w, and -h. 


Let’s push glslViewer to run in the background by 
pressing CTRL+Z. Once back in the Terminal, open your 
file again and you can keep editing! 


nano shader. frag 


By following along with the ‘Hello World’ chapter 
in The Book of Shaders (magpi.cc/2ikHZhZ), you can 
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GLSL SHADERS 
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Tabs Help 


File Edit 


Tutorial 


The glslViewer will render on 
top of everything else 


Open the editor and keep 
editing your shaders to see 
what you can make 


learn more about what’s happening here, and how to 
change your code to create more complex colours and 
animation. Once you have finished editing, you can 
close your editor and close glslViewer. For that, you need 
to bring it from the back to the foreground by typing fg 
into the Terminal, and then close it with the letter Q. 


Playing examples 
There is a Python script, supplied with glslViewer, that 
will help you to download and play the examples in the 
book. To do this, check out the examples below and 
you’ ll be able to get shaders working on your Raspberry 
Pi in no time: 


glslLoader 
glslLoader 
glslLoader 
glslLoader 
glslLoader 


https://thebookofshaders. 
https://thebookofshaders. 
https://thebookofshaders. 
https://thebookofshaders. 
https://thebookofshaders. 


com/10/ikeda-@0. frag 
com/10/ikeda-01. frag 
com/10/ikeda-02.frag 
com/10/ikeda-03. frag 
com/10/ikeda-04. frag 
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Tutorial 


Hack a DJ Hero turntable to simulate a harmonograph 
and make intricate line art by scratching 


You'll 
Need 


> DJ Hero 
turntable - 
Wii version 


> WiiChuck 
Nunchuk 
adapter or 
similar 
magpi.cc/ 
2joU1FL 


> Length of 4-way 
flat ribbon cable 


Harmonograph display 
driven by the Raspberry Pi 


Control screen, drawing 
depth, and saving images 


his month we’re going to look at hacking 

an unlikely interface: we found a DJ Hero 

turntable at a local charity shop going 
cheap, so we had a go at seeing if it could be 
interfaced with the Raspberry Pi. There are a few 
versions of the turntable for different consoles, 
but the one we’re using here is designed for the 
Wii. This is the simplest design to interface to, 
because to the Pi it simply looks like an PC device. 
It’s designed to plug into the auxiliary port of the 
Wii controller, but here we wire it directly onto the 
Pi’s GPIO pins. You can cut off the end and solder 


Control parameters with 
turntable and buttons 


w% 2 
Nunchucl Ot, 0, 
unchuck or eon "2, Op 
Adapter ei = ? AO 


Wiring the Wii Nunchuk adapter to the Pi 


extension wires to it, or get a small ‘Wii Nunchuk 
adapter’ PCB and wire that to the Pi. Fig 1 shows the 
wiring you need; as there are only four wires, you can 
use a length of ribbon cable to attach it to the Pi, with 
the cover neatly clipping over the top. 


Talking to the DJ Hero 


The DJ Hero comprises a collection of buttons, knobs, 

a joystick, and a turntable. Fig 2 shows these controls 
labelled up as the functions they’ re going to perform in 
this project. The PC address of this device is @x52 and 
consists of a number of registers. To initialise the device 
on power-up, you must write the value @x55 to register 
@xF@. Note that each successive read will increment 

the address of the register read from. So, to read the 
interface status, you need to set the register to zero and 
then read data six times — these six bytes contain the 
information from the DJ deck. The assignment of bits 

is shown in Fig 3 overleaf, and at first sight looks a bit 
complex. However, this diagram has been simplified, in 
that the DJ Hero is capable of having a second turntable 
on the left-hand side, and the bits corresponding to this 
second turntable have been omitted. 


Tutorial 


DOWNLOAD 


THE CODE: 
magpi.cc/1NqJjmV 


Check out Mike's 
Bakery videos at: 
magpi.cc/1NqJnTz 


The full set of 
controls on the DJ 
Hero controller 


Tutorial 


WALKTHROUGH 
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Turntable Red Button 

Turntable Green Button 
Turntable Blue Button 

Rotary - Not Used 

Invert Screen Button 

Select Parameter to Edit Button 


Redraw Button 


Turntable Increment 


Sign Sp extend. 


Fig 3 The data block returned from the DJ Hero 


The buttons are simple: one bit in one byte of the 
returned data block, and other controls are spread 
over several bits. The two axes of the joystick are the 
first six bits in the first two bytes, whereas the values 
from the slider are in bits 4 to 1 of byte number 2. The 
rotary control’s five bits are split up over two bytes, 
whereas the turntable is scattered all over the place in 
four locations. You’1l need a bit of software to pull out 
the data you want from this block. 

The turntable returns a value, not of its position, 
but of the change in the position since the last time it 


was read. This is a five-bit signed value, with the most 
significant bit being the sign bit. To be useful, this 
must be converted into the sort of number that Python 
can understand, so bit 5 of the turntable number is 
propagated to all the higher bits in the word; this is 
known as sign extension. Also, for negative values, the 
number must be in the ‘one’s complement’ format; 
that is, with bits 0 to 4 inverted and 1 subtracted. This 
format is universally used in computer languages and 
prevents you from having two different bit patterns for 
plus zero and minus zero, meaningless concepts. 


The graphics 

We’re going to use this controller to control a simulation 
of a harmonograph. These devices were originally a very 
popular Victorian contraption, consisting of a pen on the 
end of a compound pendulum that was sent swinging 
and produced Lissajous-like patterns. Here, however, 
we’re going to simulate a system with four pendulums 
that will exceed the flexibility of any mechanical device. 
Two pendulums control the X position of the pen, and 
two control the Y position, the final position being the 
simple sum of each of the two pendulums on each axis. 
There are four parameters that control the exact path 

of each pendulum. 


01. The Amplitude or extent of the swing 


02. The Frequency of the swing, determined 


by the pendulum’s length 

03. The Phase of the swing, a fixed value added 
to the frequency 

O04. The Damping or decay, which is the slow 


reduction of amplitude as the friction takes 
energy out of the pendulum 


It’s the subtle interaction of these four parameters 
that produces the near-infinite number of patterns 
that can be obtained. There’s also the factor of how 
long you let it swing for, producing a less or more 
dense pattern. Eventually the damping will make all 
the pendulums stop, although in this simulation you 
can set the damping value to zero if you wish. 


The software 

The code for this is DJArt.py and is written under the 
Pygame framework. The drawing area is set by the 
screenSize variable, and you could make the window 
size larger simply by altering this value if you have a 
higher-resolution monitor. In addition, the window is 
wider by 100 pixels given by the controlBar variable, 
in order to have room for the editable parameters. 
The swing function is the one that actually draws the 
path of the pendulums on the screen, with the points 
calculated by the calcNewPoint function. Rather than 
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showing every point on the screen as it is plotted, we 
speed things up considerably by drawing for 40ms 
and then displaying the result. All the rest of the code 
is devoted to editing the parameters of the program. 
The initValues function sets the startup parameters; 
you might want to change this as you explore new 
combinations of pendulum frequencies. 
The DJ Hero peripheral is handled by the readDJ 
function, and the buttonFix function returns a one 
if the button is pressed, or else it returns a zero. The raw 
data returns the bit as zero when a button is pressed, 
and a one when not. The adjustPends function 
imposes a wraparound value limiting the range on 
the parameters. Keeping the amplitude at one or less 
ensures that the drawing stays within the screen area. 


Using the software 

When running, the software starts out by having a 
starting set of parameters producing a pattern ona 
black background. The - (minus) button will toggle 
the background between black and white. Fig 4 shows 
the full program window against a white background. 
The Redraw button will run the simulation for a 

time determined by the ‘Drawing Depth’ slider; with 
the slider to the left, you get the shortest time. The 

+ button allows you to edit the parameters of each 

of the four pendulums and the track colour. The 
selected pendulum’s parameters are displayed in 

that colour, with the others shown in the foreground 
colour. Changing a parameter is simple: just press 
the appropriate colour button on the turntable and 
move it clockwise for an increase, or anticlockwise for 
a decrease. For example, the pendulum’s frequency 

is shown in red, so holding down the red button and 
moving the turntable will change the frequency. 
However, there are four parameters and only three 
buttons. The fourth parameter is amplitude and 
coloured yellow; to change this, simply hold down both 
the red and the green keys at the same time. 


Pendulum X1 
Frequency 1.0 
Phase 0.0 
Damping 0.0 
Amplitude 1.0 


Pendulum X2 
Frequency 20 
Phase 0.0 
Damping 0.01 
Amplhude 0.8 


Pendulum ¥1 
Frequency 2.02 
Phase 0.2 
Damping 0.01 
|Ampliucte 1.0 
Pendulum ¥2 
Frequency 6.0 
Phase 0.0 
Damping 0.01 
Amplitude 0.8 


Track 
Red 255 
Green 
Blue 0 


Fig 4 The control screen, and the result of different parameters 
taken from the controller 
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Tutorial 


MAKE SCRATCH ART 


There’s no point in producing great pictures if you 
can’t save them, so this is where the joystick comes in. 
Move it fully left to save just the picture and fully up to 
save the picture along with the parameter values. The 
first time you do this, a dialogue box will prompt you 
for the name and place to store the image. After the 
first one is saved, subsequent saves append a number 
to the file name. Once a picture is saved, there is a 
‘saved’ message in the lower left-hand corner of the 
window which lasts until you press another control. If 
you want to use a new name or new folder, then move 
the joystick fully to the right or fully down and you will 
get the file dialogue box next time you save an image. 


Fig 5 Designs 
created using the 
DJ Hero controller 
in this tutorial 


Getting good results 

The patterns look best on the screen with a black 
background, but if you’re going to print it out then 

it looks a lot better on a white background. We think 
the best patterns are obtained when the frequency of 
two pendulums are set as a simple ratio of each other, 
or slightly off a simple ratio, like 1:2.01. Unrelated 
frequency values tend to produce scribble-like, chaotic 
results. It’s amazing how small changes in phase 

or damping can radically change the picture. This is 
especially true of the phase, which wraps round every 
cycle; as this is shown in radians, this is at a value of 
5.3. When changing a parameter, there’s a short real- 
time preview of the resulting shape. Other parameters 
have lower limits of either zero or one, while the 
colour has an upper limit of 255. You can actually get 
Lissajous figures if you want by setting the amplitude 
of pendulums 1 and 3 to zero, and the amplitude of 

the other two to one, along with a decay of zero. Fig 5 
shows a Selection of patterns we have obtained so far. 


Taking it further 

The only control not used is the rotary one. You might 
like to try to add some code so that this controls 

the thickness of the plotted line. Altering the short 
variable value to a larger number alters the depth of 
the pattern preview; you might like to make this bigger 
if you’re using a Raspberry Pi 3, because it can draw 
faster. You could also add software to change the colour 
of the track according to the absolute X or Y position 

or change it between two colours, either abruptly or 
fading from one to the other over a length of track. 
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Tutorial STEP BY STEP 


BUILD THE 


Know when your family get home with this beautiful Harry Potter-inspired clock 


> Servos 
(continuous and 
position) 


> Watch hands 


> Arduino Uno 
magpi.cc/ 
2l04uNA 


> 2x Mini 
breadboard 
magpi.cc/ 
2LOjISN 


> Transparent 
medium 
breadboard 
magpi.cc/ 
2l0fNVW 


> Pimoroni 
Explorer HAT Pro 
magpi.cc/ 
2l0n5ZZ 


> 2x 5V mini 
DC relay 
magpi.cc/ 
2l0ere6 


> 4x LED, male- 
to-male and 
male-to-female 
jumper cables 


> Abox or 
clock body 


> Background 
graphics 


TESTING 
THE CLOCK 
MECHANISM 
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e all love the many visual elements in the Harry 
Potter movies, and this project combines two 
of the most iconic: the Marauder’s Map and 
the Weasley ‘who is home?’ clock. The project uses a 
Raspberry Pi to detect the presence of people on the 
network and an Arduino Uno to control the clock hands. 


Preparing the setup 

We Start the project by setting up the Raspberry Pi and 
Explorer HAT Pro. Install the libraries for the Explorer 
HAT Pro using the tutorial on the Pimoroni GitHub page 
here: magpi.cc/210fDOk. In this project we will be using 
two of the 5V DC outputs from the HAT to activate a 
relay. Note: These ports don’t actually output 5V, but 
connect to ground when activated. 


Configure the code 
Clone the Python code from magpi.cc/21OfkTJ. 
You will need to find the MAC addresses for each 


SPENCER ORGAN 


Chemistry and physics teacher, 
Raspberry Pi enthusiast and Certified 
RPi Educator from the West Midlands 
with a passion for running workshops 
and building fun, educational, and 
practical things with the Pi! 
magpi.cc/2bkQ53q 


of the devices you will be detecting on the network, 
and substitute them into the code. It is important 
that all the devices are on the same network as 

the Pi. On an iOS device you can find your MAC 
address under Settings > General > Wi-Fi address, 
on an Android device, it’s in Settings > About phone 
(or tablet) > Status. 


Connect the servos 

We then need to connect the two servos to the 
Arduino. Use a breadboard to connect a common 5V 
and ground line from the Arduino. Connect the red 
power cables on each of the servos to the common 5V 
line, and the brown wire to the common ground. Use 
jumper cables to connect the orange signal wire of the 
continuous servo to digital pin 12 on the Arduino, and 
the orange signal wire of the position servo to digital 
pin 11. The continuous rotation servo will become our 
second hand on the clock face, and the position servo 
will show whether people are home or away. 


ARDS 


=> 


Positional servo used to 
show who is home or away 


Continuous rotation servo to 


give it a more clock-like feel 
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Above The coil connectors of the relay are connected to 5V 

and output on the Explorer HAT Pro. The switch connectors are 
connected to digital input 1 (and 2 for the second relay) and the 
ground on the Arduino 


>STEP-04 
Connect the LEDs 
We will be using four LEDs to light up different parts of 
the Marauder’s map. Connect the short leg (cathode) 
to acommon ground. Connect the long leg (anode) to 
digital pins 5,6,7, and 8. 

The following LED pins are used: 


Digital Pin5 = Person2 
Digital Pin6 = Away notification 
Digital Pin7 =Person1 
Digital Pin8 = Home notification 


>STEP-05 

Link the Pi and Arduino 

Before connecting the relays, we will need to look at 
the pin guide and identify the two pins for the coil and 
the two pins for the switch. One side of the coil on 
both relays should be connected to the 5V output on 
the Explorer HAT Pro. The other side of the of the relay 
coil should then be connected to output 1 and 2 on the 
Explorer HAT Pro. The common switch connector on 
both relays should then be connected to the common 
ground on the Arduino. The switch connector on the 
first relay is connected to Digital 1 on the Arduino, and 
the switch connector on the second relay is connected 
to Digital 2. We will be using the switch connector, 
which is activated when the relay receives power. 


>STEP-06 

Assembling the project 

We will need to download the code for the Arduino and 
upload it to the Uno from here: magpi.cc/21OfkTJ. We 
then need to assemble our project. In our example we 
have used a fruit box, but you could use an old clock, a 
cardboard box, or a hobby box. We need to (carefully) 
screw clock hands to the two servos; take care not to 
move the servo as it can cause damage. Mount the 
two hands so that that the continuous rotation servo 
can move freely and the positional servo can move up 
and down. 


raspberrypi.org/magpi 


MARAUDER'’S CLOCK 


clock.py 


!/usr/bin/env python 


>PYTHON 


DOWNLOAD: 
import subprocess magpi.cc/2lOfkTJ 
import time 


import explorerhat 


occupant = ["Person 1 device","Person 2 device"] 


# MAC addresses for our devices - in order of people above 
address = ["XX:XX:XX:XX:XX:XX", "XX:XX2XX2XX2XX2XX"] 


while True: 
print("starting loop") 
output = subprocess.check_output( 
"sudo arp-scan -1", shell=True) 
print ("starting scan") 
for i in range (len(address)): 
if address[i] in output: 
print address[i] 
print occupant[i] 


if "XX:XX:XX:XX:XX:XX:XX" in output: 
#Person 1 MAC address 
explorerhat.output[@].on() 


else: 
explorerhat.output[0].off() 


if "XX:XX:XX:XX:XX:XX:XX" in output: 
#Person 2 MAC address 
explorerhat.output[1].on() 


else: 
explorerhat.output[1].off() 
time.sleep(60) 


CONNECTING 
THE RELAYS 


_ If the output 
from the relay 
is reversed 
(i.e. on when it 

_ should be off), 

_ try swapping 
the pole of 
the switch on 
the relay. 


Left The Arduino, 
Raspberry Pi, 
and relays are 
mounted on 

the rear of the 
case with long 
jumper cables so 
that the box can 
be opened 
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FREQUENTLY 
ASKED QUESTIONS 


F.71.Q. 


YOUR QUESTIONS ANSWERED 


NEEDA 
PROBLEM 
SOLVED? 


Email magpi@raspberrypi.org or 
find us on raspberrypi.org/forums 
to feature in a future issue. 


Your technical hardware and software problems solved... 


RASPBERRY PI 
SECURITY & 
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Password 

Raspbian uses a default password that is quite well 
known - this is to allow kids to have easy access to 
their Raspberry Pis. Other operating systems use 
different passwords and even force you to set a new 
password after install. 


SSH 

By default, SSH is turned off on Raspbian. The default 
password and connection name are well known, so 
SSH could let people snoop in on the Pi and find out 
what you’re doing. This can be turned back on very 
easily using the configuration tool. 


Network 

Since Raspbian and most Raspberry Pi OSs are run 

on Linux, they’re very secure from the majority of 
network attacks. Especially with SSH turned off or the 
default server name changed, you’re unlikely to finda 
problem day-to-day. 


Change password 

Changing the default password for your operating 
system is a good first step to adding further security to 
your Raspberry Pi: just make sure you remember what 
it is! To do this, open the Terminal and type passwd. 
Enter the current password and then the new one you 
want to use. 


Encryption 
The SD card stores all your data, and this can be easy 
to read on other computers or Raspberry Pis. You 


can easily encrypt the file system using a tool called 
eCryptfs. There’s a good tutorial on how to do this, 
which can be found here: magpi.cc/2nv57wr. 


HATs 

There are a few HATs and add-ons that allow for 
further security, privacy, and encryption on the 
Raspberry Pi. These are very popular with enterprise 
users of the single-board computer and add a physical 
layer of protection to the Pi. 


Browser 

The default browser in Raspbian is Chromium, which 
is the base of Google’s Chrome OS. It’s quite secure, 
and you can easily add pop-up blockers or extensions 
that deal with malicious ads. There’s also the benefit 
that Raspbian runs on Linux, so website malware has 
less chance to affect your system. 


Scratch 

Online Scratch does allow you to create games and 
programs and publish them anywhere, but there is a 
login system that allows you to access your projects 
more easily. This can also be used to create a login 
system in your Scratch game. 


Python 

Python is able to scrape data off the web, such as 
weather or time or stock numbers. Be careful with the 
online information you use and make sure it’s parsed 
through Python, which can make everything into a 
string of text. Try not to run this information outside 
the Python environment. 
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WHERE CAN | BUY A RASPBERRY PI? 

You can buy a Raspberry Pi from our main distributors, 
Premier Farnell/element14 and RS Components/Allied 
Electronics. Both distributors sell all over the world. There 
are also many resellers of Raspberry Pis, both online and in 
bricks-and-mortar stores. 


HOW MUCH DOES IT COST? 

The Model A+ costs $20, the Model B+ costs $25, the Pi 2 
costs $35, the Pi 3 costs $35, the Pi Zero costs $5, and the 
Pi Zero W costs $10, plus local taxes and shipping fees. 


WHAT DO 1 GET WHEN | BUY ONE? 

You get the Raspberry Pi board itself. A power supply and 
SD card are not included, but can be purchased at the same 
time from most places that sell the Raspberry Pi. You can 
also purchase pre-loaded SD cards. We recommend buying 
these from us or our licensed distributors rather than from 


the WDLabs logo are registered 


third parties on eBay, as our software is updated regularly 
and cards sold by third parties can quickly become outdated. 


WHY IS THE PRICE IN US DOLLARS? YOU ARE A UK 
COMPANY! 

The components we buy are priced in dollars, and we 
negotiate manufacturing in dollars. Because currency 
markets are so volatile, we price the final board in dollars 
too, so we don't have to keep changing the price. 


CAN | BUY A RASPBERRY PI KIT? 

Raspberry Pi resellers produce some fantastic bundles for 
people who would rather get everything they need froma 
single source. In 2016, we put together our own Raspberry 
Pi Official Starter Kit. The kit is available to order online in 
the UK from our partners element14 and RS Components, 
priced at £99tVAT, and from distributors and resellers 
around the world. 
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r LJ Kis SLs 
COMPUT S 
ANY WHERE 


MEDIA STICK DESIGNED FOR 
RASPBERRY PI COMPUTE MODULE 


Seamlessly access the computing power of the Raspberry Pi 
Compute Module* to transform any HMDI display into a media 
hub or custom digital signage. 


Includes: 

e Upgradeable adapter board with a 
builtin CM programming mode 

¢ Case for Adapter Board 

¢ LED on/off button 

e 1x HDMI port, 2x USB ports, 1x USB Micro B port 


*Raspberry Pi Compute Module and Media Stick Cable sold separately. 


Learn more at wdlabs.wd.com/magpi56b 


is a traclemark of the Raspberry Pi Foundation. microSD is a trademark of SD-3¢ 
‘age Capacity, one gigabyte = one billion bytes. Total accessible capacity varies 


RASPBERRY PI OS GALLERY 


RASPBERRY PI 


a} k | k i he Raspberry Pi is amazing. We’re probably a 
ad c al OC O d S mC is Vy little biased, but it’s hard to argue against it. 
While the hardware is great, it’s important to 


O Dp iS if all 1 1g) Q S V Ss I S cal not forget the software that makes it so fantastic, and 


at the very core of this is a good operating system. 
; | b le f h There are a fair few to choose from on the Raspberry 
av al | ad ©) i i C Pi. While you’ ll be safe with Raspbian the vast 
majority of the time, there’s plenty of choice if you 
want to tweak your Raspberry Pi to be truly optimal 
for your build or project. 


Not sure where to begin? Have no fear, here’s our 
list of every current Raspberry Pi OS. 


Also known as armhf, this makes use 
of the Raspberry Pi's processor for 
maximum efficiency. This is preferred. 


If not using hard float, an OS for 
Raspberry Pi is using soft float. 
This type of OS doesn't use the 
full hardware of the Pi and can 
reduce performance. 


Aspecific release of Linux, which while 
not an operating system itself, can 
become one with programs added 

on top. 


Aspecific version of a distribution, 
usually with slightly different 
software included. 


\ 
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RASPBIAN 


The all-purpose operating system = Raspbian 


et’s start with the premier Raspberry Pi 
operating system, Raspbian. It’s a specific INFO 
spin of the ARM version of Debian 7.0 Jessie 
that is optimised for the Raspberry Pi. Debian is a very 
easy-to-use Linux distribution that is well supported: 
you have lots of software to choose from and it’s 
simple to install. 
The core Raspbian system is not maintained by 
the Raspberry Pi Foundation itself but it is heavily e deve 
promoted, and used by, Raspberry Pi. It’s maintained 
in such a way that means it is compatible with 
Raspberry Pis running on all three chipsets, allowing 
for some level of backward compatibility. It does run 
best on Raspberry Pi 3, though, where it has a little 
more power to make use of. 


While Raspbian does by default log into a desktop 
environment, you can easily modify it to log into RASPBIAN 
the command line instead. This option can be found 
with several other options for enabling or disabling WITH PIXEL 
services such as SSH and the Camera Module, making 
it very easy to modify. 


COs 


6G 


Ale $xesee 


Gc 


RASPBIAN LITE 


~SUG8S0885 Epi 


@ Official Raspberry Pi software SD card image 
and hardware work best on it is on the larger side 
@ Easy to use Uses more resources 
@ Easy to set up than other operating 
systems 


@® Most tutorials online use it 
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feature 


RISC OS OPEN @ 


ALL-PURPOSE 


General-use operating systems that 
you can use for normal computer tasks 


PI-TOPOS: =n ( 
POLARIS — [== 


online account so you can access most of 
your data from any pi-top or Raspberry 
Pi running pi-topOS. 

While it can be used like a desktop, it’s 


As, 


\ pi-topOS:Polaris 


he pi-top is a Raspberry Pi- 
powered laptop (and later desktop) 
build that was successfully 
crowdfunded less than two years ago. It alot more angled towards learning to 
qj INFO has a huge educational focus and for that, the pi-top code than desktop use. This may be preferable if you’re 
team have created a special operating system called giving it to a young person, but for others looking fora 


b Built for pi-topOS to go with the hardware. more pure desktop experience on Raspberry Pi, this is 
pi-top computers It allows for easy access to coding apps maybe not the place to look. 


; : like Python, and also includes lessons and 
i Designed for education 
worksheets to follow so you can learn Python. 
b Comes with CEED There’s also Minecraft Pi, Scratch, and Sonic 


URIVarcorecCational Pi, just like on Raspbian. It also comes with @ Interface looks similar No access to extra 


its own special educational game called CEED to smartphones cece, programming 
Universe — an RPG-esque game where you solve @ Great learning resources simone 
puzzles using code, along with puzzles that involve @ CEED Universe is great MeMNIS 2 eC Se 2 


experience 


physical electronics. It’s all set up with a universal login, 


UBUNTU MATE | = 


buntu is almost synonymous with Linux. 
It’s one of, if not the most popular Linux 
distributions out there and it’s managed to gain 
this reputation thanks to driving Linux-based operating 
systems to be more user friendly. 

As well as the main version of Ubuntu, there are 
several popular spins of it that use different 
desktop environments along with other little ® Good software library Not as fast as Raspbian 
tweaks and fixes, including Ubuntu MATE, @ Good desktop experience No access to 


which uses the more classical-looking @ Easy to get extra Raspbian 
programming libraries 


ubuntu-mate.org 


INFO 


b Based on the very 
popular Ubuntu 


4 


Debian core, like Raspbian MATE desktop environment. It’s known for @ Well maintained 
being lightweight and straightforward and 
|) More of a pure desktop it’s gained popularity among the other spins work on the Raspberry Pi 2 and 3 and they have ample 
experience on PCs for this very reason. power to run it well enough. Raspbian runs just a little 
It’s also the only desktop Ubuntu that works bit better, though. 
> uses PANE ace hele on Raspberry Pi, and while known for being It doesn’t have all the amenities of Raspbian either 
SUSSITECE A lightweight and fast compared to its peers on PC, — no GPIO Zero, no built-in Scratch, etc. It does have 
it’s relatively resource intensive on the Raspberry Pi. access to a wide range of software, though, and generally 


G That’s not to say it is bad and slow — it’s designed to works a little better as a desktop PC. 
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fedora” 
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The stock.Linux distnibutions built tor Rasa =nn 


FEDORA 


magpi.cc/2miaZUL 


@ ARM build of the popular Fedora OS 
@ Currently onversion 25 @ Made for Raspberry Pi 2 & 3 
@ Desktop-orientated as standard 


Fedora is a classic Linux distribution much in the same 
way Ubuntu is, although Fedora is a little older. It’s well 
known for using the latest and greatest Linux software, 
testing and using it before most other big Linux operating 
systems. While there have been a few Raspberry Pi 
specific Fedora spins in the past, these days stock Fedora 
is built using ARM and can run straight on a Raspberry Pi. 


ARCH LINUX 


magpi.cc/2nf6YFk 


@ An early Raspberry Pi OS 
@ Very customisable 
@ Recommended for more advanced users 


Arch Linux ARM is the spin of Arch that works on the 
Raspberry Pi — although there’s a couple of versions 
specifically for the Raspberry Pi. One is optimised for 
the original versions (including the Pi Zero) while the 
other works well on Raspberry Pi 2 and 3. Arch is very 
barebones, offering a command-line interface as 
default and a minimal suite of software as standard. 
From here you can build it up and customise it as you 
wish, although there’s a little less software available 
for Arch ARM than for the full PC version of Arch. It’s 
great for software-heavy projects that need access 

to as many resources as possible from the Pi. Make 
sure you get the correct version for your Raspberry Pi 
chipset, though. 


i Bm@eEoOPYS 


Fedora offers a clean desktop experience and is 
quite popular among programmers. It’s also a good 
place to see the latest software available for the 
Raspberry Pi chipset. 


GENTOO () 


magpi.cc/2neUygW 


@ Linux you can build, almost from scratch 
@ For advanced users familiar with Linux 


Gentoo is a step beyond Arch. Whereas Arch gives youa 
basic, functioning OS that you can build upon, Gentoo has 
you build everything up as you go along. This goes as far as 
selecting kernel modules in the Linux kernel - core pieces 
of software that allow for different pieces of hardware to 
run. It's not for everyone, but if you have a mastery of Linux 
you can create a heavily customised operating system for 
your Raspberry Pi. Of course, you won't then have access to 
packages like GPIO Zero or Minecraft Pi. 


SARPI 


magpi.cc/2mirKkip 


@ Supports hard float and soft float 
@ Slackware ARM on the Raspberry Pi 
@ Notan official release @ For advanced Linux users 


While not an official release of Slackware, SARPi merely 
repackages Slackware ARM in a way that makes it installable 
on Raspberry Pi. Slackware is a very old Linux distribution that 
has been around for many years, focusing on stability above 
all. It comes with the most barebones install of all the Linux 
distros on this page - it doesn't even have a command-line 
interface as default. If you want to learn the nitty-gritty of 
Linux, running Slackware is a good place to start. It might take 
a little while to learn, though. 


Make the most of your Raspberry Pi with these slimmed down OSs 


MINIBIAN 


magpi.cc/2mgkCDg 


dietpi.com 
@ Designed for embedded 

Lighter than Raspbian Lite DietPi systems or server 

Based on Debian Jessie @ Command-line interface 

Very light graphical interface @ Based on Raspbian 

over command line &> 

Minibian takes a very similar approach to DietPi, although instead of offering 
Claiming to be three times lighter than even a menu system like Whiptail, it's gone full command-line interface with 
Raspbian Lite, DietPi is a very stripped down the way it works. Once again, it’s based on Raspbian and while it hasn't 
version of Raspbian, albeit with more than just been updated in a year, the last release was created to make sure it was 
a command line. It uses Whiptail menus — very compatible with the Raspberry Pi 3. 
simple graphical menus rendered in the CLI that It's very much designed as a release for people who want to use the 
barely use any extra resources, and definitely use a Raspberry Pi as a server or an embedded system, the kind you'd find more 
lot less than a traditional graphical desktop. commonly in businesses than at home. It is also compatible with all of the 
Being based on Raspbian means it does have Raspbian software as well, allowing it to be used like Raspbian itself if the 
access to a lot of the great programming software need arises. This release probably isn't for everyone, though. 
that comes with it — including easy libraries for 
controlling the GPIO ports with Python and such. V¥PROS 
One of the unique aspects of DietPi is its task 
manager, which allows you to easily tweak the @ Great for servers and headless projects Command-line interface 
priorities for different tasks running on your Pi - @ Works with Raspbian software Niche appeal 
particularly useful if you’ve chosen DietPi to make 
sure certain tasks get as much power as possible. 
It is also structured with certain types of project 

in mind, providing automation features anda 
comprehensive logging system. While this may all magpi.cc/2mgxJod im o> =| | LU) = 
sound fairly advanced, it’s actually quite easy to get 
your head around, while offering some easy-to-use Incredibly small Still hard float 
advanced options. Designed for speed 


Probably one of the smallest operating systems you can get for the Raspberry 
- ae ; Pi, Moebius boasts that you only need a 128MB SD card to install it, and that it 
‘Install Optimized Software——@ 
na 8 only takes up 20MB of RAM by default. The latest version is currently in beta 


DietPi-Config Feature rich config tool for your device. i i rT j iti 
Sepa am aes caeciaen amie eters tan testing, which adds support for Raspberry Pi 3 (although at the time of writing, 


DietPi-Autostart Choose what software runs after boot. H 
DietPi-Ccron Modify the start times of cron jobs. the beta only works on Pi 3). 


DietPi-Process_Tool Tweak Nice, Affinity, Schedulers for programs. . . ae ee . 5 
DietPi-Drive_ Manager Setup and control multiple external drives. It'sa much more extreme version of Minibian, even going so far as using 


Re ieee some components from Raspbian to make sure it still makes use of hard float 


1 
Please select a program to run: 


<Exit> on the releases. It's an interesting OS, best suited to tasks that require as little 


power and space as possible. Hopefully the newer version will also work on Pi 


Zero for a truly minimal experience. 


Embraces being Whiptail menus are not 
be de us ata Only needs a128MB SD card Latest version still in development 
Rests close. Please) gee use 20MB RAM usage Extremely limited by default 


in default state 
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Looking to set up a public internet access point? Here's what could helior 
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CHROMIUM 
OS FOR ALL SBC 


magpi.cc/2njuVeS 


@ Gives access to all Google products 
@ Uses cloud storage @ The core of Chrome OS laptops 


Chrome OS should be familiar to a lot of people: it’s Google's operating 
system based on the firm's browser and which comes loaded on its laptops 
and other computers. The idea is it’s all cloud based, with storage via Google 


Drive and an office suite with Docs and such. It's had varying levels of success, 


but as it’s built from the open Chromium base, it was open for being hacked a 
bit to work on Raspberry Pi. 

Chromium OS for Raspberry Pi works just like Chrome OS, which is great, 
although it can be a little sluggish at times. For a web kiosk, you have to jump 
through extra hoops to get it working for multiple users. It seems more suited 
for home then, perhaps as a kitchen computer for quickly accessing recipes. 


Y PROS 


@ Familiar interface Active development seems to have stopped 


@ Access to Google apps Tricky to modify for web kiosk use 


linutop.com l ‘ k 
Based on Ubuntu (? 
Paid-for web kiosk OS 

Compatible on PC and Pi 


This is the only paid-for OS in this guide and it is something that a lot of 
businesses pay to use. Whereas with other operating systems you need to 
do some tweaking to get it working well as a kiosk, Linutop does all the hard 
work for you. They even sell boxes with OS pre-installed (the smallest of 
which is powered by a Raspberry Pi), requiring little setup to get it working. 

There's no login required with the Linutop either - you can just let people 
securely browse the web. All the settings are locked away and reset for each 
new session. They even provide remote-control software so you can manage 
your web kiosk from afar. 


Well supported Core OS is not Raspbian 


Professional software Not free 
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@ @ chromium 


@ Can support digital signage 
@ Free to use 


feature 


WEBKIOSK ,* 


magpi.cc/2mgv3Xv 


@ Free web kiosk software 
@ Uses Chromium for browsing 
@ Allows for secure browsing from the Raspberry Pi 


This is actually two operating systems in one 
— a pure, easy web kiosk OS for letting people 
browse the web in your cafe or hotel or whatever, 
and a digital signage version that is a touch more 
restrictive, only showing the browser itself. 
Compared to Linutop, it is free and uses 
Chromium instead of Firefox for browsing: a 
minimal difference, but one that many people 
might prefer. It’s unclear whether or not it is still 
being fully developed. The last release was in July 
2016, so it supports the Raspberry Pi 3, which is 
probably the best model to use for a Pi-powered 
web kiosk. 


Core OS is not Raspbian 
No remote control 


MagPi 


&% Movies 


OSMC 


osmc.tv 


@ Built on Kodi core 


( 
@ Previously RaspBMC 


@ Uses custom interface by default 


OSMC 


You’ll hear a lot about Kodi on these pages — it’s the 
media centre software used by many projects and 
products that allow you to play back media on your TV. 
It’s an excellent core for any home theatre PC, so it’s 
great that OSMC not only uses Kodi, but is completely 
up to date with the latest version. 
OSMC sets itself apart from stock Kodi by using 
its own interface as default, trying to make it easier 
to navigate your media or add it in the first place. 
Compared to its main alternative, LibreELEC, it’s 

a little heavier resource-wise, although it doesn’t 
make a difference in terms of actually playing 


your media. It’ll run 1080p video with ease and is 
compatible with a huge array of codecs. 


@ Kodi base New default Kodi skin 
possibly better 


@ Playback is as good 
as the Pi can handle Fewer ties to Kodi dev 
team than LibreELEC 


Kung Fury 


Whether you want to play some games or just watch some TV, there's a Pi OS for you . | 


libreelec.tv 


Close ties to Kodi dev team 4 
Successor to OpenELEC 
Stock Kodi experience 


For a long time, OpenELEC was actually our Kodi OS of choice for the 
Raspberry Pi. Especially during the days of the original Raspberry Pi when 
resources were at a premium, having as light an OS as possible to run Kodi 
was great. Development has splintered a bit and LibreELEC has risen as the 
successor to OpenELEC, with just enough OS for Kodi. 

It runs an almost pure stock Kodi, with a few extra LibreELEC menus on 
top to handle extra settings and updates and such. It also has the benefit of Y 
being optimised for the new interface for Kodi, which is definitely a marked . 


improvement over the old one. It’s still our preferred choice, especially on 
older Raspberry Pis and the Pi Zero. 


About as light an OS as possible Slower off the mark with new 

for Kodi Kodi releases 

Great update system AirPlay doesn't work well 
xbian.org 


Veteran Raspberry Pi OS 
Based on Debian Has a custom installer 


One of the original Kodi OSs on Raspberry Pi, Xbian has been around for 
nearly five years. It offers a stock Kodi experience on a pared-down version 
of Debian/Raspbian, which means you can then install other software 
underneath Kodi if you so wish. On the original Raspberry Pis this was a Little 
risky as you only had limited resources, but with the Pi 2 and Pi 3 there's a bit 
more power to make use of. 

Xbian still retains this ability, as well as being packaged with an easy-to-use 
installer that automatically burns an SD card for you. It gives you a bit more 
flexibility this way, in exchange for some optimisation, although you'll only 
notice issues on original Raspberry Pis and Pi Zero. 


Kodi base Heavier than other Kodi OS 
Easy install system Not great on Pi Zero 
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AVL 


magpi.cc/2mgp451 la xb 


@ Slackware build with Kodi 
@ Comes with standard desktop 
® Already built, just need to install 


When we talked about Slack on an earlier page, we mentioned that it is great 
for building up the exact operating system you want. SlaxBMC is an excellent 
example of this: a Kodi OS for Raspberry Pi built on Slackware. You don't have to 
build it from scratch yourself, though: you can just grab the image and burn it to 
an SD card to use straight away. 

SlaXBMC is a bit different in that it also Lets you log into a standard graphical 
environment by exiting Kodi. This way you can turn your Pi into a living room 
PC if you wish. However, this does mean that it has a much larger image and 
uses a few more resources than other Kodi builds. 


® Choice of install options Uses older Kodi 
@® Quick access to normal desktop Large image sizes 


Heavier on resources 


retropie.org.uk 


Easy to set up 
Retro game player 
Emulates tons of consoles and old PC games 


The premier retro game emulation software for Raspberry Pi, RetroPie is 
the heart of many retro gaming projects. It allows emulation of basically 
everything pre-SNES and a few things after it, along with arcade games and 
some PC stuff like SCUMM. It did start off a little rough around the edges, but 
over the past couple of years it has sharpened up to become an amazing and 
easy-to-use piece of software. 

It also includes a few features for making sure it is kept up to date, and 
even supports netplay between RetroPie devices. No media playback at the 
moment, though (although it is being tested), so it’s purely for games. 


Very easy to set up No traditional media playback yet 


Extensive list of emulators Need to source your own games 
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Video Player 


magpi.cc/2mgsIMk 


Media server system 
Aimed more at business 
Back-end server and front-end player system 


If you remember MythTV, you might be familiar 
with how PiBox works. A media server Keeps all 


r media organised, which can then be securely 
t to one or more media player boxes on the 


same network. Whereas with Kodi you’ re having to 
interact with Windows or Linux file servers, this is 


alo 


t more contained. 
does use the same hardware acceleration as 
pbian and Kodi does, and can even stream 


webcam video. It’s not quite as easy to use overall 
as Kodi, although in many ways it offers more 


opti 


ons in exchange. 


Makes use of hardware No Kodi core 
acceleration Less easy to set up 
Same software for both ends 

of media playback 
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. SERVICE 


OWNCLOUD 


ownCloud software 
@ Cloud storage solution 
@ Can stream media across network 


Pi distro, it’s great to see it all ready to use wi 


handily turns a Pi into a cloud server for your 
network or beyond. It even connects to popu 
storage providers like Google Drive and Drop 


magpi.cc/2mu5HW4. sa. 
EO, 
@ Uses popular OUNM Cc lo U 


OwnCloud is very good and while you could spend 
an evening setting it up on another Raspberry 


th 


Raspberry ownCloud. It runs on ownCloud 9.1 and 


local 
ar cloud 
box. 


Additionally, it has UPnP and DLNA streaming set up 


so you can use it to stream media around you 


RESINOS 


resinos.io 


resin 


@ OS for containers 
@ For Docker and dev work 
@ Powers resin.io 


Pi that allows you to use and create containers 
Raspberry Pi installs. It's an excellent tool if you 


r house. 


Docker and containers are excellent development and 
deployment tools, allowing you to test out different 
scenarios on different installs that are almost like virtual 
machines. ResinOS is an operating system for Raspberry 


for 
like to 


use more advanced Linux and programming methods. 


d 


Cloud, server, or Docker — heres a selection of operating systems for different utilities 


RASPBERRY @ 


eet #PiNet 
@ Easy to use 

®@ Available on NOOBS 

® Centralised server for Raspberry Pi classroom 


PiNet is a great piece of software, providing a server of students’ user 

accounts in a classroom that uses Raspberry Pis to teach. It’s all very well 
documented and kept up to date, and it means that kids don't have to carry 

their projects with them on SD cards. Outside the classroom, it could be used ( 
to create separate test environments for your software. 


MOTIONEYEOS 


magpi.cc/2nqLuFT 


@ CCTV software 
@ Allows for remote monitoring 
@ Motion activation features 


We’ve used motionEyeOS in the past for a couple of projects and it’s 
a great little operating system for any project that requires remote 
access to acamera. Whether it’s full-on CCTV or just watching your cat 
flap, it’s got a lot of great features to make sure all your surveillance 
needs are 
satisfied. 

It works with 
the official 
Camera Module 
as well as USB 
webcams, 
and supports 
multiple 
input streams. 
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NARD SDK 


magpi.cc/2nqWK4K 


@ Runs everything in RAM 
@ Designed for embedded systems 


Avery popular use for the Raspberry Pi is embedded 
systems - computers running all day, every day for great 
lengths of time that don't get looked at or serviced very 
often. These kinds of uses usually require a slightly 
different approach to the operating system and this is 
where Nard comes in. Importantly, it loads the system 

to memory so that if there's a power cut there’s a much 
lower chance of the SD card becoming corrupted. It also 
has auto-repair tools for the SD card file system. It even 
emulates Raspbian if you need it to. 


|| xo rin@epia: ~ - Shell - 
Session Edit View Bookmarks Settings Help 


KALI LINUX 


magpi.cc/2nqTdUL 
@ Pen testing distro 

@ Used for testing security 

@ Portability on Raspberry Pi is useful 


Kali has a reputation as one of the better pen 

testing Linux distros, aimed at helping people find 
vulnerabilities in their systems. Portability of Kali is 
pretty key, so a Raspberry Pi with Kali installed is a 
great tool for checking network vulnerability issues 
as well as problems with individual machines. The 
Raspberry Pi image is a streamlined version of Kali, 
but there is a full version you can install if you need it. 
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y gH Windows 10 


SNAPPY 
UBUNTU 
CORE 


magpi.cc/2mvRB6U 


ubuntu 


An ultra-lightweight version of Ubuntu that can be 
used for loT, but also for embedded systems, cloud 
servers, and more. As it's Linux, it may be more 
familiar to people who are already programming 
and using Raspberry Pi in their projects. It's well 
supported and full of great software packages. 


INTERNET 
OF THINGS 


MagPi 
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OUBEAD 3 OUBPOP JO SPOCA OOF 


of coding 6 
creating 
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£12.99 


200 pages of 


RASPBERRY PI 


PROJECTS BOOK 


VOLUME 2 


Amazing hacking and making projects 
from the creators of MagPi magazine 
Inside: 

How to get started with Raspberry Pi 
The most inspirational community projects 
Essential tutorials, guides, and ideas 


Expert reviews and buying advice 


Available 
n— magpi.cc/MagPiStore 


plus all good newsagents and: 


WHSmith BARNES&NOBLE 


> Google Play fi] A, Amazon 


raspberrypi.org/magpi April2017 MagPi 


4 Available on the 
@ App Store 
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Maker 
says 
A buffet 
of sensors, 
inputs, and 
displays 
to explore 
Android 
Things 


Pimoroni 


RAINBOW HAT 


ENVIRO 
PHAT 


This Zero-size 
board features 
four different 
sensors, for 
measuring 
temperature, 
pressure, light 
level, colour, 
motion, and 
direction, plus 
analogue inputs. 


y 


£16 / $20 
magpi.cc/29NHB3T 
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riginally known as Project 

Brillo, Google’s recently 

relaunched Android Things 
operating system is designed to 


and blue respectively). The most 
visually impressive feature is 
the SPlI-operated ‘rainbow’ arc 
of seven super-bright APA102 


be used with IoT devices including 


the Raspberry Pi 3 
the trouble of con 


. To save you 
necting various 


individual electronic components 


to your Pi to try ou 


t the new system, 


RGB LEDs that gives the HAT 

its name. PWM is employed for 
the piezo buzzer, which can be 
used to play buzzy tunes. [?C is 
also used for the BMP280 sensor, 


Pimoroni has designed the all- 
singing, all-dancing Rainbow HAT. 
Jam-packed with LEDs, buttons 
and sensors, it enables you to 
experiment with Android Things 
and use it with the wide range of 
protocols available on the Raspberry 
Pi, such as GPIO, PC, SPI, and PWM. 
To show numbers and letters, 
there’s an ?C-connected four- 
digit alphanumeric display, 
which is a cut above the standard 
type with 14 segments per digit, 
enabling it to accurately show the 
full alphabet. GPIO is used for the 
three capacitive touch buttons and 
their built-in LEDs (red, green, 


which measure temperature and 


pressure. Finally, t 
15 breakout pins fo 


here’s a line of 
r servo, PC, SPI, 


and UART - all powered by 3V3. 


One notable omissi 


on, however, is 


an accelerometer/magnetometer, 
as featured in Pimoroni’s Enviro 


PHAT - possibly th 


ere wasn’t room 


on the board for one. 
The Rainbow HAT can be 
programmed using Python in 


Raspbian, but we fi 


rst tried it out 


with Android Things (see boxout for 
more details). Since the coding — 
via a remote computer — is mainly 
done in Java, it helps if you have a 


working knowledge of the language. 


A versatile HAT to try out Android Things or use with Python 


Alternatively, like us, you can import 
one of the example projects from 
the Android Things GitHub repo 
(magpi.cc/2mFNxTe). The first time 
you do this, you’ll be prompted to 
install and update various tools and 
plug-ins, which is a bit of a hassle, 
but after that it works smoothly. 


Android examples 

To start with, we tried out the 
sample-button app from the 
Android Things repo. All it does is 
light up the LED of the Rainbow 
HAT’s capacitive button A when 
you press it. By digging into the 
code, you can change the GPIO 
pin numbers to use a different 
button and LED, although you’ ll 
need to refer to pinout.xyz to 

find the correct numbers. Next, 
we imported the weather station 
project, which showed off more of 
the HAT’s capabilities. By default, 
the segment display displays the 
current temperature, although 
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@ Rainbo 
on on Oe 


we soon noticed it rising. As usual 
with a board-mounted sensor, this 
is due to the heat from the board 
and the Raspberry Pi just below 

it, but you could always calibrate 

it by comparing the real ambient 
temperature (using a standard 
thermometer) to discover the 
average difference. A press of a 
button switches the display to 
pressure, which is also indicated by 


4669004 


ngs @ 


the rainbow arc and showing AHOY, 
YARR or GROG on the alphanumeric 
display depending on the capacitive 
button pressed! Other examples 
include a temperature gauge and an 
RGB/HSV lamp whose shade is set 
using the touch buttons. 

A look at the library example code 
— or the getting started tutorial at 
magpi.cc/21X6Jih — reveals a simple 
syntax for using the HAT’s features, 


The most visually 
impressive feature 1s the 
SPI-operated rainbow’ arc 


the rainbow arc of LEDs. You can 
also configure this example app 
to publish sensor data to Google 
Cloud Pub/Sub, from which you 
can process it and visualise it using 
various Google tools. 
Alternatively, in the Raspbian OS, 
Python can be used to program the 
HAT. There’s a dedicated library, 
added using the one-line installer. 
Example programs include a pirate- 
themed demo that plays the What 
Shall We Do with the Drunken Sailor? 
sea shanty on the piezo buzzer while 
gradually changing the colour of 
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such as weather. temperature 
to obtain temperature data and 
display.print_str(‘AHOY’ ) 
to show a string on the four-digit 
alphanumeric display. 

Whether programmed using 
Python or Android Things, the 
Rainbow HAT has an impressive 
number of features crammed into 
it, making it useful for all sorts of 
projects. Suggestions from Pimoroni 
include a weather station, stopwatch 
or countdown timer, three-note 
piano, reaction time game, and 
mood light. 


Once you've downloaded the latest preview 
image of the Android Things OS (from 
magpi.cc/2lWvvPg), you can flash it to a microSD 
card to insert in the Raspberry Pi. On booting 

up, it shows a logo with network connection 
information underneath - you'll need to hook 
the Pi up to the router via Ethernet at first, as 
there's no way to set up wireless connectivity 
beforehand. With the Android Studio application 
installed on a remote computer, you can then 
connect to the Pi from a terminal using the adb 
tool from the SDK. You can then start building an 
app in Android Studio and deploy it to the Pi. 


android 


things 


PAtun TOC Anse Mentor NB Version Conv 


Android Studio helps you program the Rainbow HAT 


A potpourri of LEDs, buttons, and sensors makes 
the Rainbow HAT very useful for experimenting 
with Android Things, or programming with 
Python in Raspbian. It may be overkill for some 


projects, but it’s a versatile add-on that offers 


good value for money. 


kek 
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£112 / $119 


Maker 
says 


“ — - a ~ . ‘ + 
Fully 

compatible 
hardware 8 

Feopbeny Pi 8 
and software 
Western Digital —" 

= 


WD PIDRIVE 
COMPUTE CENTRE 


OFFICIAL 
STARTER 
KIT 


If you want a 
Raspberry Pi 
computer kit 
but you're not 
interested in 
the larger hard 
drive, then 
take a look 

at the official 
kit instead. 


£99 / $139 
magpi.cc/2nrY33i 
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Build a Raspberry Pi computer with a 375GB hard drive 


estern Digital has 

been bringing its hard 

drive range to the 
Raspberry Pi thanks to a series of 
PiDrive devices. 

These combine the Raspberry 
Pi microSD card with a larger WD 
hard drive to provide a Piwitha 
beefed-up storage system. 

The WD PiDrive Computer 
Centre features a Raspberry Pi 3 
and a WD PiDrive Foundation 
Edition 375GB package. You 
also get a wireless keyboard and 
mouse and a plastic case to hold 
both the Raspberry Pi and WD 
hard drive. 

Assembling the hardware 
proved easy enough. Simply screw 
the Raspberry Pi board to the base 
of the case and then screw the 
hard drive in next to it. AUSB cable 
splits out to provide power to the 
Raspberry Pi and the hard drive. 
Included are a power adapter and 
all cables. 


The lid comes with a magnetic 
top, so it’s securely slotted to 
enclose the drive, but can be 
quickly removed to access the 
Pi and hook the GPIO pins up to 
electronic components. 


Foundation Edition 
It’s the Foundation Edition software 
that makes this system sing. 

It would have been easy just to 
produce a kit that uses the hard 
drive as an external drive toa 
regular Raspberry Pi. 

However, WD has taken the time 
to produce a custom edition of 
NOOBS that works directly with the 
main drive. 

You select SDA1 during the 
installation process, and it walks 
through the process of installing 
Raspbian with PIXEL. From then 
on you have a version of Raspbian 
running on the full 375GB hard drive. 

Not only that, but WD has 
produced a custom edition 


of BerryBoot alongside its 
Foundation Edition Software 
(magpi.cc/2ns5InA). BerryBoot’s 
boot selection screen makes it 
easy to add multiple operating 
systems to your Raspberry Pi, and 
the ample storage gives them 
space to breathe. 

We added Ubuntu Mate 16.04, 
OpenELEC, and RetroPie, all 
alongside Raspbian. Each OS had 
plenty of space for files. 

All in all, we liked this kit. 
Adding a large hard drive 
transforms the Raspberry Pi, and 
it’s all enclosed in a nice mini 
desktop-style case. 


{ast word 


A lovely piece of kit that 
offers excellent Raspberry 


Pi integration with a larger 
hard drive. 
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IQAUDIO 
PI-DAC+ 


Based on 

the same TI 
PCM5122 chip, 
IQaudlO's HAT 
delivers similarly 
impressive 
sound quality. It 
can be stacked 
with a Pi-AMP+ 
to use passive 
speakers, too. 


£30/$40 
magpi.cc/2mFj87h 
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Music sounds better with a HAT on 


he JustBoom range of Pi 
products comprises three 
main types — DAC, Amp, 
and Digi — featuring different sets 
of outputs for different uses. Each 
is available in full-size HAT and 

Pi Zero-size pHAT form, ready- 
assembled. All are based on the [?S 
(inter-IC sound) standard. 

Here we’re taking a look at the 
DAC HAT, which delivers its sound 
via an amplified 3.5mm headphone 
socket, or twin RCA outputs 
connected to a hi-fi system or 
powered speakers. While the HAT 
features a 384kHz/32-bit DAC chip 
(the TI PCM5122), this is limited by 
the Pi’s Linux drivers to 192kHz. 
Nevertheless, the sound quality 
proved mightily impressive in our 
tests. Both CD-quality 16-bit tracks 
and 24-bit HD audio files were 
played with crystal clarity, even via 
a modest Sony mini hi-fi system. 
Classical music in particular benefits 
from the enhanced clarity and detail. 


The DAC HAT comes pre- 
assembled, so you just need to 
mount it securely on the Raspberry 
Pi using the supplied plastic spacers 
and bolts. As well as slots for 
Camera Module and touchscreen 
cables, this well-designed HAT 
features a full (unpopulated) GPIO 
breakout. The packaging includes 
an optional IR receiver, for you 

to solder on if you want to use a 
remote control. There’s also the 
option to fit the HAT in a sleek 
plastic case (£13 / $17). 

It’s then a case of deciding 
which OS to use. A whole host are 
supported, including Volumio, 
OSMC, OpenELEC, Roon, and 
Max2Play (for which a 30-day 
free trial is included). Most are 
easy to set up with the HAT. In 
Raspbian, it involves commenting 
out one line in /boot/config.txt 
and adding three, one of which 
enables playback from Sonic Pi. 

A quick reboot and it’s ready to 


A plug- 
and-play, 
high- 
resolution, 
digital-to- 
analogue 
converter 
for the 
Raspberry Pi 


JustBoom 


—— 
22000000 
‘612 = 


L 


use, although we found we needed 
to boost the digital volume in 
alsamixer for headphone playback. 

One final trick up the DAC HAT’s 
sleeve is the ability to stacka 
standalone Amp board (£60 / $79) 
on top, featuring block terminals 
so you can connect it directly to 
passive speakers. You’ll need an 
additional power supply to get full 
power (30W RMS) out of it. 


{ast word 


Delivering audiophile sound 
at an affordable price, the 
well-designed DAC HAT is 

an impressive piece of kit. It 
offers a huge improvement in 


quality over the Pi’s standard 
3.5mm audio jack, and sounds 
particularly impressive when 
playing back lossless formats. 
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VZHTZI ~=PICAPTURE HD1 


Maker 
says 
High- 
definition, 
low-latency 
video capture 
for the 
Raspberry Pi 


Lintest Systems 


PICAPTURE HDI 


Capture video using your Raspberry Pi with this inexpensive capture card 
that also doubles as a HAT 


his is a very interesting This is important, as the CSI has a creative balancing (it’s quite a bit 
kit/HAT for the Raspberry __ direct (and very high bandwidth) wider than the Zero is), you could 
Pi. Video capture usually connection to the main BCM probably get it to work. With the 
requires machines that offer a chip on the Raspberry Pi, which form factor the way it is, though, 
FEBON100 decent amount of power so they contains VideoCore. Installed likea you’d be better off with an A+. 
UVC CVBS can stream or convert an input HAT on the Raspberry Pi, PiCapture With the hardware all attached, 
There are a few signal into a video. However, draws power from the GPIO ports, you can then record your video 
DSBicapiure due to the way the PiCapture is and can connect vial?C or UART.It input. As this is done through 
ees built and optimised, it connects also handily extends the GPIO pins —_ the camera connector, you can 
Raspberry Fi, straight to the Raspberry Pi’s above the board so you can use use Camera Module software to 
althoughithese VideoCore graphics processor, and them for other tasks. preview and record the video; no 
une is able to make full use of it for It’s an incredibly neat and extra software needed! It’s an 
resolutions. video capture. well-thought-out design, and incredibly smart way to do it as it 
This is the HD version of the because VideoCore is the same also means it’s instantly usable in 
PiCapture, which supports input in all versions of the Raspberry Python for more advanced projects 
via HDMI and component video. Pi, it will work on any Pi witha and uses. A typical use would be to 
The HD and SD versions share 40-pin GPIO port — even a Model record video, and show a preview 
£62/$77 the same connection to the Pi A+. Raspberry Pi Zeros aren’t at the same time, so that you can 
through the GPIO ports, and via included on the spec sheet, but watch the preview on your monitor 
the camera connector (CSI) port. with a little modification andsome _ or TV during recording. 
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PICAPTURE HD1 


£130 / $159 : 


Sl &eEFeEEReFEeFe oo Ff = 


LF <> St 8” ED 
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CD > 


Above The colours 
are washed out and 
quite different from 
the original here 


As well as Python, you can use 
raspistill/raspivid on it, which is 
pretty good for making sure the 
input is working on the board. 

This is unfortunately where the 
PiCapture’s limitations start to 
show. The video is smooth, the 
picture appears at the correct 
resolution, and there’s no 
discernible input lag, even while 
playing games. However, the 
colours are alla little bit off. 

It’s a bit of a deal-breaker. With 


Left Depending on 
the video, the colour 
problems may not 
be as apparent, but 
they're still there 


the right kind of video it won’t It’s a little bit of ashame. Yes, mixture of hardware it is using 
be noticeable, and if you’re a compared to getting a full rig to complete the task. As it works 
dab hand with the likes of Adobe and video capture setup this isa with Python, it could still be used 
Premiere, you should be able to lot cheaper, but it does require a to monitor specific video streams 
for motion, for example in a CCTV 
] ] project. It also theoretically means 
Compared to g etting a full Ig it will work a bit better with the 


input from something like a DSLR 
or other video camera, as it feeds it 
straight through the CSI port. 


and video capture setup, 
this is a lot cheaper 


tweak the colours to be more little more work to make it look 
like the original. There’s also the anywhere near as good. For content {ast word 
matter of there being no sound that doesn’t require exact colours ee eee 
recording capability, so you’ll have __ it will do the job, but don’t expect betes ts va er ee 
; piece of kit that unfortunately 
to marry up externally recorded to record perfect 1080p60 video : 
; j é ae ; stumbles somewhat when it 

sound with the video in an editing from a HDMI source, especially as 

f bean : aibedsaied comes to the actual task of 
program. Un ortunate y, there is at 1080p, you will be limited toa video capture. 
no way for the CSI input to take 30fps recording. 
sound as well as video, so it’s not For what it is, it’s still pretty 
the PiCapture’s fault. amazing. It’s just limited by the 
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RASPBERRY PI 
BESTSELLERS 


Apress brings a diverse range of maker 
topics to its ‘Technology In Action’ series 


CRAFTING WEARABLES: 
BLENDING TECHNOLOGY 
WITH FASHION 


Author: Sibel Deren Guler 
Publisher: Apress 

Price: £22.99 

ISBN: 978-1484218075 
magpi.cc/2nfbQKS 


Guler's scattergun approach to 
this diverse topic has interesting 
facts and ideas in every section. 
It touches on the elementary 
skills you need, leaving you with 
more questions - and the urge 
to find the answers. 


BEGINNING FPGA: 
PROGRAMMING METAL 


Author: Aiken Pang 
Publisher: Apress 
Price: £29.50 

ISBN: 978-1430262473 
magpi.cc/2nfkUPK 


If you want to really grasp 

logic gates, computer 
hardware, and close-to-the- 
metal programming, field- 
programmable gate arrays 

are your path to enlightenment. 
Challenging but fun. 


RASPBERRY PI GPU 
AUDIO VIDEO 
PROGRAMMING 


Author: Jan Newmarch 
Publisher: Apress 
Price: £22.99 

ISBN: 978-1484224717 
magpi.cc/2nfenEA 


The missing manual for GPU 
programming on the Pi - 
particularly with OpenMAX 

and OpenVG. You'll need a 
reasonable grasp of C, but 
Newmarch gives you everything 
else. Very code heavy. 
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HEAD FIRST 
PY THON 


and sets, is a firmer foundation 
than starting with control flows. 
Functions follow, and making 
your own modules, which you 


then install in the cloud 
Author: Paul Barry Put First at PythonAnywhere, to 
Publisher: O'Reilly support the web app you 


Price: £39.99 
ISBN: 978-1491919538 
magpi.cc/2nfiscb 


Whether or not 
you like the 
quirky, visual 
style of O’Reilly’s Head 
First books, this is an excellent 
introduction to Python, well written 
and well paced. Aimed at those with 
at least a little coding experience 
in another language, Paul Barry’s 
text starts iconoclastically by 
sidestepping Hello World, and 
diving into a more in-depth first 
program, bringing in the list data 
structure, importing from the 
standard library, and introducing 
the powerful in operator. 

The data-first approach, with 
lists, then dictionaries, tuples, 


TMUX 2 


PRODUCTIVE 


MOUSE-FREE 
DEVELOPMENT 
iy 


Author: Brian P Hogan 
Publisher: Pragmatic 


Bookshelf tmux 2 
Price: £17.50 Bea Ree 
ISBN: 978-1680502213 4 


magpi.cc/2nfg9jQO 


An 80-page book on 
a command-line 
tool might seem 
a negligible product, but when you 
see it’s from Brian Hogan, author of 
Exercises for Programmers (five-star 
review in The MagPi #42), you know 
that its claims to make you more 
productive are worth investigating. 
If you’re used to tabs in browsers 
or terminals, you’ll be familiar 
with doing more than one thing 
within a window. tmux is a terminal 
emulator which lets you do several 
command-line tasks within 


write with Flask. Difficult 
subjects like decorators, 
comprehensions, and 
generators are painlessly 
introduced, as our app is 
constantly refactored, and 
communicating with an SQL 
database is carefully taught. 

PEP8 gets an early mention, but 
otherwise testing is left. Nor is there 
anything on Jupyter or doing data 
science, for example, but this is a 
book that teaches a lot, very quickly, 
and confident learners who find 
other introductory books too slow- 
paced will get a head start in Python 
with this Head First guide. 


Score 


a terminal or virtual console. “Your 
mouse is slowing you down,” 
says Hogan. Keyboard-controlled 
environments mean you don’t have 
to break concentration on typing as 
you switch between tools. 
tmux allows multiple ‘windows’ 
of command-line sessions, 
as well as dividing up 
the terminal window 
into panes like a tiled file 


7 manager. tmux sessions 


can exist independently of 
the terminal running them, 
reattaching them to your shell 
as required — great for running 
on headless Raspberry Pis or 
web servers, where you may want to 
leave quite complex command-line 
sessions running after you log out of 
SSH. There’s plenty more to tmux, 
as Hogan outlines, from scripting to 
pair programming. Try it and boost 
your productivity. 


Score 
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bod er CaN 
DOT 


Authors: Sophie Deen & 
friends 

Publisher: Bright Little Labs 

Price: £12.99 

ISBN: 978-0995636200 

detectivedot.org 


Detective Dot 
has high-tech 
gadgets, amusing 
sidekicks, and an arch-nemesis, 
but where she differs from most 
fictional detectives is not just that 
she is nine years old, and working 
for the Children’s Intelligence 
Agency (CIA). She is also a coder 
and inventor. 

Leveraging youngsters’ addiction 
to screens, as well as being available 
for tablets and phones, with or 
without CIA membership, the book 
features heavy smartphone use, 
and in particular a modified selfie 
stick. Dot can talk to tech, as well 


PROGRAMMING 


LANGUAGE 
EXPLORATIONS 


Programming 


Authors: Ray Toal, 


Rachel Rivera iid a 
Publisher: CRC Press Aesnder She» Eise Cig 
Price: £49.99 | ma | = 2 
ISBN: 978-1498738460 a BE 
magpi.cc/2nfnIMT ey 2s 
We all know that 
having learnt 
one or two 


programming languages well, better 
understanding will come through 
learning several more, particularly 
those embracing different 
paradigms, but it’s hard to find the 
time. If only there were some way of 
concisely getting the most relevant 
features from other languages. 
Enter Programming Language 
Explorations, a book to open your 
eyes to theoretical concepts through 
practical lessons. 

Twelve languages are covered, 
with an emphasis on ideas rather 
than features. A right-angled 
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Language Explorations 


as code. The code she writes during 
the book is all available at the end of 
the story, in both plain 
English algorithm form, 
and Python, along with 
her secret report and 
supplemental facts on 
both tech and the CIA. 
Sophie Deen, former 
program manager at Code 
Club — and Code Club Pro — 
set up Bright Little Labs and 
wrote the first (of many, we 
hope) adventures of 
Detective Dot, to address a number 
of problems in literature, the media, 
and the world. Managing a fraction 
of this within a book that entertains 
pre-teens is areal achievement, 
and the CIA’s Code of Conduct: 1. 
Question everything, 2. Think for 
yourself, feels like the summary of 
everything Dot does and discovers. 


Score 


triangle generator opens each 
chapter, giving a useful starter in 
each language’s style and approach. 
After the basics, languages are used 

to introduce particular concepts, 

or how features are expressed in 
that language — but every feature 
is not repeated unnecessarily in 
each language chapter. 

For each language, chapters end 

with where to go next for reading, 


g Be om understanding, and participating 


(with interesting open-source 

projects listed), as well as 20 or 30 
exercises to embed the learning. 
After JavaScript, CoffeeScript, 
Lua, Python, Ruby, Julia, Java, 
Clojure, Elm, Erlang, Go, and Swift, 
a lightning tour of “the classics” 
describes what was/is important in 
everything from Fortran to APL. A 
summary of concepts covered anda 
choice of where to go next complete 
a very worthwhile investment in 
improving your coding abilities. 


Score 


ESSENTIAL READING: 
MODERN WEB 


New frameworks, better performance, and 
dependable standbys - web development 
demands a multi-skill approach 


Angular 2 Development 
with TypeScript 

Author: Yakov Fain 

Publisher: Manning 

Price: £36.62 

ISBN: 978-1617293122 
magpi.cc/2nfbSlP 


Learn why Angular 2 really can live up = 
to the hype, as you develop an example 
online auction app. 


UX Research 


Authors: Brad Nunnally, David Farkas 
Publisher: O'Reilly 

Price: £23.99 

ISBN: 978-1491951293 
magpi.cc/2nfbUKt 


Usability research techniques weighted 
and compared. Thorough and practical, 
with great examples, and practitioner 
interviews. For any product you're planning. 


Learning React 


Author: Kirupa Chinnathambi 
Publisher: Addison-Wesley 
Price: £24.99 

ISBN: 978-0134546315 LEARNING 
magpi.cc/2nfmPnj ACT 


Thoroughly accessible introduction to 
the JavaScript library for building user 
interfaces (the V in MVC), and building 
apps with it. 


High Performance 
Images 

Authors: Colin Bendel, et al. 
Publisher: O'Reilly 

Price: £27.99 High 
ISBN: 978-1491925805 
magpi.cc/2nfmscm 


Pert formance 
Images 


From colour theory and image formats, 
to the problems of responsive images - a 
an essential guide to a complex topic. 


PHP and MySQL Web 
Development al “ 


Authors: Luke Welling, Laura Thomson @ 
Publisher: Addison-Wesley 
Price: £30.99 

ISBN: 978-0321833891 
magpi.cc/2nfptcK 


PHP and MySQL. | 


Web Development 


Fifth Edition 


PHP & MySQL are not trendy, but totally 
ubiquitous through WordPress, Drupal, 
and a dozen other essential LAMP 
projects. A comprehensive introduction. 
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he Raspberry Pi is five years old! Released 

on 29 February 2012, the Raspberry Pi has 

created a huge community of digital makers 
of all ages and genders from around the world. It has 
also helped reform the UK computing curriculum and 
sold in the millions. The Birthday Weekend at the 
start of March was an excuse to celebrate all of this. 
We were even there to show off the magazine! Here 
are some pictures from the various festivities. 


The official cake of the party changed colours as you 
tweeted it! There was a real cake, though. It was yummy 


MagPi April 2017 
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The venue for the party was the Cambridge Junction, a 
classy building that just about housed all the festivities 
Pi-powered games and gizmos were everywhere at the 
party, like this giant game based on Operation 
Foundation CEO Philip Colligan gave a keynote speech 
on the Raspberry Pi 
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THIS MONTH IN Pl 


< 


2 
Eben enjoyed the face-painting stall § # F 
yoy’ p ig Z. FAG 


Robots galore at the party! There were 
races and demos throughout the halls 


oooweres 


Plenty of practical demonstrations went on in ie 
workshops, teaching people how to use the Pi P 


Fran Scott came by to perform some 
explosions - real explosions - with code 


AUDIO VISUAL 


Want to see more from the party? You can catch a 
glimpse of the talks and activities in the Big Birthday 
Weekend video, on the Raspberry Pi YouTube account 


here: magpi.cc/2mAard6. You might even spot The 
MagPi team... 


—S— 2 = 
Big Birthday Weekend 2017 — 
agi 
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FEATURE 


Every year on 14 March, the internet comes 
together to celebrate Pi Day. In date formats where 
the month comes first (such as 2017-03-14), 

3/14 is the first three digits of the mathematical 
constant pi. We always like to celebrate on Pi Day, 
not only because of the name but also because of 
the STEM connotations. This year, Raspberry Pi 
illustrator Sam Alder and The MagPi contributor 
Alex Bate put together a very important list, 
showing the differences between pies and Pis. No 
one should go without reviewing its contents. 


_ Sugar- and fat-free i Really, really not. Nope. 


Powers people 


Saving a slice requires 
extreme willpower 


Top with optional ice cream 


Eat it @every_opportunity 


Powers robots 


Successful operation 
requires 2.5A power 


Top with optional HAT 
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raspberrypi.org/magpi Magazine 


e’re very proud to announce that here at The 

MagPi we’ re now doing videos! As well as the 

wonderful words we write, you can now see 
and hear us on the Raspberry Pi YouTube channel. 
We launched with our very own introduction to the 


Look forward to tutorials, 
reviews, unboxings, and 
even interviews 


Raspberry Pi Zero W, hosted by our very own and 
very handsome features editor, Rob. Look forward to 
tutorials, reviews, unboxings, and even interviews in 
the future for The MagPi. Watch our first video right 
here: magpi.cc/2mAbzxm. 
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CROWDFUND THIS! 


The best crowdfunding hits this month for you to check out... 


InsPiRing 
Sculpt lights with 


INSPIRING = 


X 7 
= 


There are many ways to use LEDs with the Raspberry 
Pi, and Alex Eames has come up with yet another 
excellent idea for how to use them: by creating strips 
and shapes of LEDs that can be attached in different 
ways and used to easily build up a project in any way 
you desire. It’s already hit its goal, so it’s a good time 
to help fund it further and get your hands on some. 


RASPBERRY PI 
WATER GUN 


Ever wanted a fun Raspberry Pi kit that teaches you 
coding, making, and gives you an excellent prank at the 
end of it? The Raspberry Pi Water Gun is a kit you can 
build that lets you create a trap that squirts would-be 
pranksters with water. It’s fun and daft and we love the 
idea, so head on over to the Kickstarter if you want to 
give it a hand. 
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If you have ever used Python to control the 
GPIO pins then you have Ben to thank, 
as he created the RPi.GPIO library 


en has always been a 
maker at heart. For his 
first project he created 
a home automation system while 
still in school, and learnt to build 
a robot in the late 1980s, using 
one of the Usborne books and a 
BBC Micro! 

Ben Croston loves to brew 
beer. In fact, when he took 
voluntary redundancy from 
British Aerospace he saw it as 
his chance to take a passion and 
turn it into a business. At British 
Aerospace, Ben had worked on 
data acquisition and simulation 
systems using engineering 
principles and knowledge to trick 
the avionics of an aircraft to think 
that it was flying while recording 
the data for later analysis. 

So when Ben took voluntary 
redundancy, coincidentally just as 
the Raspberry Pi was first being 
announced, it was natural for 
him to think about the brewing 
process and how it could be 
improved using technology. 


As Ben frequently mentions during 
our chat, “Brewing is scientific 
and it requires a high degree of 
consistency in order to reproduce 
the same beer time and again.” 

So how can technology help 
the process? Ben has employed 
a Raspberry Pi to manage the 
heating system used to brew the 
beer. It provides a web interface 
for remote access and monitoring 
of the temperature in the hot 
liquor tank. This uses a DS18B20 
temperature sensor, the same 
sensor that is used in the CamJam 
Edukit #2. It even provides a fail- 
safe option to ensure that the 
water is maintained at the correct 
temperature — all part of the 
complex brewing process. 

His original idea was to use 
RPi.GPIO to control the heaters 
and motors using a series of 
sensors. Ben has plans to add 
further Raspberry Pis to his 
brewing systems, including the 
fermentation system. It takes 
a week for the natural sugars 
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to become alcohol. During the 
fermentation process, the yeast 
requires careful temperature 
control in order to produce a 
product of a consistent quality. 
The GPIO and Ben’s library 
have enabled anyone to build 
their own physical projects, but 
did Ben foresee this success? 
The simple answer is no. The 


he sees something new, created 
using a library that he created to 
“scratch his own itch.” 

These constant innovations 
and projects show that there is 
a need for children and adults 
to have access to an easy-to- 
use tool for physical computing, 
and that by abstracting some 
of the complexities we can help 


Ben has plans to add 
further Raspberry Pis 
to his brewing systems 


popularity of the Raspberry Pi and 


his library could not have been 
predicted, and this is something 


which humbles Ben. He is amazed 


at the number of projects that 
have been created using his 
library. Every time he opens 
The MagPi and looks on a blog 


everyone to get started with 
digital making. Ben is a keen 
advocate of children learning to 
code. He isa STEM Ambassador, 
and visits local schools to talk 
about the scientific processes 
that are required to brew beer 
at a commercial level. 


Ben shows off his first GPIO project, from more 
than 20 years ago: a home automation system 
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Ben transfers the freshly brewed beer to a ‘copper’ tank, 
where it will pass through a heat exchange 


RPI.GPIO 
The original library that has powered hundreds 


of thousands of Python GPIO projects around the 
world. Created as a means for Ben to interface 

his brewing equipment with the Raspberry Pi to 
ensure consistent brewery practices, this library 
has helped many to realise their own physical 
computing projects with Raspberry Pi and Python. 
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Community 


INTERVIEW 


KEEPING YOUR 


HAT OPEN 


Is there a way to use only open-source tools to design and manufacture Raspberry Pi 
accessories? Leon Anavi was determined that there should be for his Pi HAT 


Below A simple 
home-made board 
for flashing the 
HAT’s EEPROM 
saves having to buy 
a professional tool 


t’s relatively easy to put 

together a few discrete 

components, and perhaps 
a chip or two, on a breadboard, 
to prototype and build your own 
accessory to connect up to the 
Pi’s GPIO pins. But how about 
something neater and more 
professionally packaged? The Pi 
HAT format (see ‘Pi HAT°’ box) 
is a piece of standardisation that 
has resulted in several dozen 
popular add-ons, but it’s alsoa 
clear specification that can be used 
to make your own HAT. We even 
published an introductory tutorial 
on this in The MagPi #42. 

Leon Anavi, a programmer 

from Plovdiv in Bulgaria, was 
inspired to try this for himself, 


> 
2] 


90000 


as his first hardware project. 
“?’m_a software guy,” he admits. 
“Take anything that I say about 
hardware with a pinch of salt.” 
Later, he self-deprecatingly tells 
us, “The combination of a software 
engineer and a soldering iron could 
be dangerous.” 

Having bought the first ever 
HAT - the Sense HAT - for some 
IoT experiments, he discovered 
some limitations. Given sufficient 
processor load — something not 
difficult to achieve, particularly 
on single-core Pis — the heat 
generated by the CPU actually 
affects the Sense HAT’s 
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temperature sensor, which proved 


a particular proble 


m when Leon 


built a weather station. Another 


problem for protot 


yping is the 


Sense HAT’s 8x8 LED array — very 
pretty, but not all that suitable 
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for a text display. Leon decided to 
try to make his own board, witha 
better-placed temperature sensor. 


- 


3 Se 
mi be i o 


Leon is a senior software 
engineer with Konsulko Group, 
which provides open-source 
consultancy in embedded software, 
particularly for the automotive 
industry — an industry where you'll 
often find the Pi in a prototyping 
role. Long a fan of free and open- 
source software — and inspired by 
presentations about open-source 
hardware at FOSDEM and Hackaday 
Belgrade, given by Tsvetan Uzunov 
— Leon brought his passion for 
all things open source to his new 
interest in hardware, challenging 
himself to use open-source tools 
throughout the project. 


Prototyping 

Leon presented his experiences 

at FOSDEM [see The MagPi #55, 
pp82-83], where we caught up 
with him. He spoke of the purpose 
of his talk: for people to “get 
inspired — as soon as you get back 
from FOSDEM, [I hope] you’ ll 
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pick up a soldering iron and start 


prototyping.” The video of the talk ; 


is up on fosdem.org, but to save 
your bandwidth we’ll summarise 
here, and add in what Leon told 
The MagPi afterwards. 

For prototyping your own HAT, 
you don’t need a great deal of 
fancy equipment, but you do need 
an idea. This could be as simple 
as blinking an LED, the ‘Hello, 
World!’ program of the hardware 
world, used in our issue 42 tutorial. 
While you can breadboard the 
circuit for your idea, to test it out in 
HAT format, the best way to try out 
your idea is by using an Adafruit 
Perma-Proto HAT. 

You’ll need an EEPROM if you 
want to conform to HAT standard. 
Leon outlined the device tree, 
originating in open firmware, which 
is used to describe the hardware 
using key-value pairs ina tree of 
nodes. The device tree is found in all 
modern ARM devices. The CAT24C32 
is the recommended EEPROM: 
an 8-pin DIP, talking to the PC 
interface. Flashing the chip takes a 
few simple steps, from the software 
point of view, but you do need a 
suitable device. As befits a hobby 
project, Leon made his own EEPROM 
flasher, using a breadboard to attach 
pins 3 and 5 of the EEPROM to GPIO 
2 and 3 for flashing, and to GPIO 27 
and 28 to read it back [see picture] 

— accomplished here by moving it 
from the left side to the right side of 
the breadboard, powering off the Pi 
in between. 
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Mentoring 
Having made a working prototype, 
Leon’s next step was to design 
a PCB - first with a cardboard 
mock-up, to think through the 
placement of the components, then 
with CAD (computer-aided design) 
software. Many hobbyists use cut- 
down, free-of-charge versions of 
professional proprietary software, 
but as Leon wanted to work 
entirely with free and open-source 
software, his first choice was KiCad. 

This choice was influenced not 
just by the advantages outlined in 
the ‘KiCad’ box (overleaf), but by 
ocal hardware company Olimex 
— developer of the TERES-I DIY 
aptop [see our FOSDEM coverage 
in The MagPi #55] — being heavy 
users and supporters of KiCad, 
and running some workshops in 
its use. A particular influence was 
ocal KiCad expert, Rangel Ivanov, 
who also helped with Leon’s next 
project (described later). 

When trying something out for 
the first time, particularly ina 
new field, never underestimate 
the utility of having someone local 
you can turn to for help — whether 
their mentoring is just a reassuring 
presence, or detailed debugging 
assistance. The range of help given 
within the Raspberry Pi and wider 
maker community is something we 
find quite inspiring. 

Leon acknowledges plenty of 
help in creating his first DIY HAT. 


The Infrared pHAT in its natural 
home, on a Raspberry Pi Zero 


RASPBERRY PI HAT BOARD SPECIFICATION (c) Respberry Pi 2014 
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Nevertheless, he claims to have 
repeated a lot of common mistakes 
along the development path, from 
not complying with recommended 
trace space sizes, to placinga 
component — a potentiometer - 
where it could be shorted out by 
the Pi’s HDMI connector when the 
HAT was moved slightly by users 
pressing the button mounted on it. 
It’s always quite comforting to 
hear about smart people making 
some of the same mistakes as 
the rest of us (if you are in the 
Tizen or Yocto communities, 
you’ ll have encountered Leon, and 


know just how smart he is), and 
it’s something to be remembered 
when you encounter problems 
along the way in developing your 
own board. 

To get the prototype board 
made, Leon chose the US company 
OSH Park, widely used in the 
maker community because of its 
combination of excellent quality 
and relatively low prices, although 
cheaper Chinese alternatives are 
available. Leon later looked for 
a local manufacturer, giving the 


added advantage of quick shipping. 


Complete package 
Originally called the RabbitMax 
Flex HAT, legal complications 
led to it being renamed as the 
ANAVI Flex. This Raspberry Pi 
HAT includes an IR photo sensor, 
RGB and IRLEDs, a slot for an 
LCD character display, anda 
usefully specced relay (rated at 
10A, 250V), as well as slots for up 
to five plug-and-play I?C sensors - 
anything that i2cdetect works with 
shouldn’t give you any problems. 
During September last year, as 
prototype boards were distributed 
to bloggers and developers, 


r aasil 


ANAVI Infrared pHAT 


. 
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software examples were written 
using the wiringPi library and 
LIRC. As aC coder, Leon was 
slightly taken aback by the demand 
for example code in Python, but 
provided it — using RPi.GPIO — 
along with C examples, and even a 
user manual, with all of it released 
under open-source and Creative 
Commons licences. 
It’s a neat little board, very 
useful not just for that weather 
tation application without 
the temperature measurement 
being skewed by processor 
load, but a good board for 
general experimentation across 
electronics, embedded hardware, 
and the ubiquitous Internet of 
Things. It is useful if you have an 
idea you'd like to try out and you 
want to get started without having 
to build the hardware for it. 
Following feedback on the 
prototypes, small revisions 
were made, and a low-volume 
manufacturing run was released and 
quickly sold out. The next step was 
a crowdfunding campaign, which 
led to a successfully funded larger 
manufacturing run — and to Leon 
trying his hand at designing a pHAT. 


n 


Below Ona 
full-size Pi, and 
mounted with 

?C sensors, the 
Infrared pHAT is not 
just an IR receiver/ 
transmitter, but 
also a humidity/ 
temperature/ 

light sensor 


+e 
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Phat pHAT 


Most readers will be familiar with 
the Pi’s HAT accessories — see the 
‘Pi HAT box if you are not — but 
those who don’t use the Pi Zero may 
have missed the arrival of the HAT’s 
smaller, and unofficial, cousin. A 
pHAT is a partial HAT, lacking the 
full, offical Pi HAT specification. In 
particular, few have the EEPROM, 
and the size is smaller, matched to 
the Pi Zero (65 by 30mm, with four 
mount holes). They can be used with 


KEEPING YOUR HAT OPEN 


ANAVI infrared pHAT 
Rev 1.0 (c) 17 
http:, WARE Sechasioms 


slots for sensors: temperature and 
barometric pressure (BMP180), 
temperature and humidity 
(HTU21), and light (BH1750). 

As an IR controller, it is close to 
plug-and-play, simply snapping 
into place, and coming with sample 
applications that make it easy to 
run on Raspbian. If you want to 
go deeper into the software, both 
Leon’s add-ons support his IoT 
GNU/Linux distribution, which 
is based on Poky. Built with the 


The purpose 1s for people to get 
inspired — pick up a soldering 
iron and start prototyping 


the Zero to make all sorts of handy 
gadgets — but, as with a regular HAT, 
they’ll work with other models of Pi 
from the B+ onwards (with 40-pin 
GPIO). pHATs are also, somewhat 
charmingly, called ‘Bonnets’ over at 
Adafruit in the US. 

Straight from the success of 
steering through his DIY Flex 
HAT project, Leon has launched 
a crowdfunding initiative for 
the ANAVI Infrared pHAT. A lot 
more specialist than the Flex, it’s 
designed as a programmable IR 
controller to use with the LIRC 
software. It has an IR receiver, 
transmitter, UART, and three [?C 
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Yocto Project and Openembedded, 
it features an open-source 
daemon for communicating with 
other Internet of Things (loT) 
objects through the lightweight 
machine-to-machine connectivity 
protocol, MQTT. 

Documentation covers the [?C 
sensors, along with software 
installation. Possible uses range 
beyond a universal remote control 
to the receiver in all types of Pi- 
based devices. There’s plenty of 
community documentation and 
tutorials on capturing infrared 
remote control signals, as LIRC is a 
mature and widely used library. 


Leon wanted to continue with 
the open-source workflow in the 
new project, but was also keen to 
see manufacure take place locally. 
We ask him how he’s got on. “I 
established a contact with a local 
manufacturing company,” he 
replies. “So it is going to be an 
open-source hardware product 
entirely designed, manufactured 
and assembled here in my 
hometown of Plovdiv, Bulgaria. 
Of course, the design is done with 
free and open-source tools only, 
like KiCad.” 

As we go to press, the Infrared 
pHAT crowdfunding campaign on 


IndieGoGo has massively surpassed 


its modest target. “It is amazing!” 
says Leon. “It is just a small hobby 
open-source project, so a week ago 
I thought that almost no one will 
be interested in it. The positive 
crowdfunding campaign has 

been already beyond my wildest 
expectations. People all over the 
world are supporting the project.” 


Community 


Left The pHAT 
works well on 
all Raspberry 
Pi models 


Below The Infrared 
PHAT is perfectly 
designed to sit on 
top of a Pi Zero 


ANAVI Infrared pHAT 
Rev 1.0 (c) 2017 
tp: //06s 
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FRANKLIN TOWNSHIP 
RASPBERRY JAM 


EVENTS 


EVENT CALENDAR 


Find out what community-organised, Raspberry Pi- 
themed events are happening near you... 


Want a Raspberry Jam in your 
area? Want to start one? 
Email Ben Nuttall about it: 


ben@raspberrypi.org 


FIGHEIGHIED EVENTS 


MELBOURNE PI USER GROUP 
When: Tuesday 18 April 
Where: Melbourne Rudolf Steiner 
School, Warranwood, 
VIC, Australia 
mpug.clarkson.id.au 
The Melbourne Pi User Group 
aims to cater to those interested 
in the Raspberry Pi and all it has 
to offer. 


QUANTUM TECHNOLOGY CLUB 

When: Thursday 20 April 

Where: Cottage Lane Mission, 
Ormskirk, UK 

quantumtech.club 

Experiment, learn, and share 

various technologies: computing 

(hardware and coding), electronics, 

Raspberry Pis, and Arduinos. 
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FRANKLIN TOWNSHIP 
RASPBERRY JAM 
When: Saturday 22 April 
Where: Franklin Township 
Public Library, Franklin 
Township, NJ, USA 
magpi.cc/2mwVIzu 
Love the Raspberry Pi? Interested 
in learning more about it? If you’d 
like to come and tinker, feel free! 


NEVERS RASPBERRY JAM 

When: Friday 28 April 

Where: 124 Rue de Marzy, 
Nevers, France 

magpi.cc/2ns6zzy 

A French Raspberry Jam that 

is being put on following the 

success of a previous ‘National 

Meeting’ of Pi fans. 


NEVERS 
RASPBERRY JAM 


me" * « MELBOURNE PI 
oO Sw @ isce crave 


REGULAR EVENTS 


CORNWALL TECH JAM 
When: Saturday 8 April 
Where: Bodmin Library, 
Bodmin, UK 
cornwalltechjam.uk 
For anyone interested in 
technology, of all ages and abilities. 
Ask questions and learn about 
programming (Scratch, Python, 
Minecraft, and much more). 


MANCHESTER 

RASPBERRY JAM 

When: Saturday 8 April 

Where: The Shed, Manchester, UK 
magpi.cc/2k476Wn 

Bring your Raspberry Pi along 
and take part in the workshops. 
There’s also a getting started 
session for newcomers. 
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CAN YOU HELP INCREASE 
THE AMOUNT OF JAMS 
IN THE AREAS THAT NEED MORE? 
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TAUNTON 

RASPBERRY JAM 

When: Sunday 9 April 

Where: Taunton Library, 

Taunton, UK 

magpi.cc/2mwTTm8s 

More chances to get hands-on Code Clubs are amazing 

with more digital making activities places for kids to learn how 

through workshops and a hackspace to code, but don’t just take 

area to share projects. our word for it - listen to 
the kids that go to them 

STAFFORD RASPBERRY JAM with the latest video on 

When: Tuesday 11 April the Raspberry Pi YouTube 

Where: Stafford Library, channel: magpi.cc/2nry9IC. 

Stafford, UK Our favourite quote is 

magpi.cc/2lzwyQu “jt makes me all excited 

A big meet-up of Pi enthusiasts inside”, which is an excellent 

where they all share ideas, help reaction to digital making. 

each other, and most of all To find out more, go to 

have fun! codeclub.org.uk 
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Hi folks, love your magazine. Can you tell me 
what IDE you use when writing the Python code 
that appears in The MagPi? Or, how can I hack 
IDLE to reproduce it? I really like the way the code 
is highlighted in The MagPi. The IDLE provided 
with the Pi uses a different, less detailed, and (in 
my opinion) less helpful colour scheme. It would 
be great to have the code in IDLE highlighted in 
exactly the same colours as in The MagPi. 
Lawrence 


We actually colour the code by 
RO EES hand in the magazine, so it’s 
not exactly something you’d be 
able to use as an IDE for writing 
Python scripts. IDLE does have 
a colour scheme that you can 
edit to a hmited extent in the 
settings, if you’re happy just to 
change a few colours. However, 
if you do a quick Google search, 
you will easily be able to finda 
range of custom highlighting 
themes for Python. Follow 

the install instructions and 
you should be able to produce 
something closer to The MagPi 


This Solarized theme is just one of 
many you can find for IDLE colour scheme. 


Ty a) 


Wireless worries 

I was very excited to hear about the new Raspberry 
Pi Zero W when it was announced. I’ve been 
wanting integrated wireless on the Pi Zero since 

it came out! I was surprised to see a very different 
type of antenna, though, compared to the Raspberry 
Pi 3. While it does look very intriguing, I am worried 
about how good it is as an antenna compared to the 
older one? Surely a little bit of cut-out board can’t 
be as good? Hope you can allay my fears. 

Les Bourne 


We actually talked to Roger Thornton, one of the 
lead hardware engineers, about the antenna and he 
told us that in theory the antenna can bea lot more 
powerful than it currently is on the Raspberry P 
Se A es ¢ . : Zero W, but needed to be reined in a bit to make sure 
Some copper has been carved out to : ~ «A it passed compliance. Basically, it’s as powerful as 


create this new style of antenna on ere) ) . ‘ 
the Pi Zero W it’s allowed to be, so you don’t have to worry about it. 


ae 
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FROM THE FORUM: 


ARTICLE DATABASE UPDATE 


The Raspberry Pi Forum is a hotbed of conversations and problem-solving for the 
community - join in via raspberrypi.org/forums 


ello. It would be very useful to have a table of This was a letter we originally had in issue 51 and at the 


contents for all issues (regular issues and all time we mentioned it would be great if there was an entire 
special topic issues) of The MagPi which could catalogue/database of our articles. A reader from the 
be searched. community called ‘ozono’ has since delivered, with a table 


For example, it would be useful when I would like to —_ of contents from all our issues! You can find the link on the 
find all issues of The MagPi which are part of aguideto forum here: magpi.cc/2mHmzZM. 
learn C (which would be issues 47, 48, and 49). We’ll try and get our own version sorted one day as well! 
Is something like this already available? If not, 


: ae > 
would it be possible to produce something like this? Have ie got solrathing ar 3 are te say: 
Get in touch via magpi@raspberrypi.org 


Best regards, or on The MagPi section of the forum at: 


Superm erlin raspberrypi.org/forums 


COMPACT 
STORAGE & 
CONPUTING 


WD PIDRIVE NODE ZERO 
FOR RASPBERRY PI 


ps nel 


Build your own mini DLNA + Samba file server, wireless mobile 
storage device, or a Pi Music Box with local storage and more. 


Includes: 
e 314GB WD PiDrive, Raspberry Pi Zero, 
and custom adapter board 
e SD card with starter software 

e Mini HDMI adapter cable 


@ WDLABS Learn more at wdlabs.wd.com/magpi56c 


Western Digital, WD, the WD logo, WDLabs, and the WDLabs logo are registered trademarks or trademarks of Western Digital Corporation or its affiliates in the U.S. and/or other countries. Raspberry Pi is a trademark of the Raspberry Pi Foundation. microSD is a trademark of SD-3C, 
LLC. The term HDMI is a trademark or registered trademark of HDMI Licensing LLC in the United States and other countries. All other marks are the property of their respective owners. As used for storage capacity, one gigabyte = one billion bytes. Total accessible capacity varies 
depending on operating environment. Product specifications subject to change without notice. Pictures shown may vary from actual product. © 2017 Western Digital Corporation or its affiliates. 


PIMORONI Ty) iS 
WIN ONE OF FIVE 


SETS OF RASPBERRY PI ZERO W 


PROJECT KITS! 


Three cute project kits for the Raspberry Pi Zero W. Solder and assemble, 
then connect and code them to make them unique to you. 


PMOROM P MORON P MORON 
S Raspberry PiZeroM 


Project Kit 


Solder, assemble, and codethis — 
scrolling notification kit. Program it 
to notify you of lots of different things 
like Twitter mentions or the ever 
entertaining news headlines. 


Which pHAT does the Pirate Radio project kit use? 


Tell us by 26 April 


for your chance to win! 


Terms & Conditions 

Competition closes on 26 April 2017. Prize is offered worldwide to participants aged 18 or over, except employees of the Raspberry Pi Foundation, the prize supplier, 
their families or friends. Winners will be notified by email after the draw date. By entering the competition, the winner consents to any publicity generated from the 
competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine (unless otherwise stated upon entry). We don't like 


spam. Participants’ details will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. 
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www.helloworld.cc — 
@ @HelloWorld_Edu oe = 
 fb.com/HelloWorldEduMag 
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me! 


ne way we achieve our mission at the 
Raspberry Pi Foundation is to find an 
intersection between someone’s passion and 
computing. For example, if you’re a young person 
interested in space, our Astro Pi programme is all 
about getting your code running on the International 
Space Station. If you like music, you can use Sonic Pi 
to compose songs with code. This month Id like to 
introduce you to some interesting work happening at 
the intersection of computing and visual arts. 

Processing is a programming language and 
development environment that sits perfectly at that 
intersection. It enables you to use code to generate 
still graphics, animations, or interactive applications 
such as games. It’s based on the Java programming 
language and runs on multiple platforms and 
operating systems. Thanks to the work of the 
Processing Foundation, and in particular contributor 
Gottfried Haider, Processing runs like a champ on the 
Raspberry Pi. 

When I want to communicate how cool Processing 
is while speaking to members of the Raspberry Pi 
community, I usually make this analogy: with Sonic 
Pi, you can use one line of code to make one note; 
with Processing, you can use one line of code to draw 
one stroke. Once you’ve figured that out, you can use 
computational tools such as loops, conditions, and 
variables to make some beautiful art. 

And even though Processing is intended for use 
in the realm of visual arts, its capabilities can go 
beyond that. You can make applications that interact 
with the user through a keyboard or mouse input. 
Processing also has libraries for working with network 
connections, files, and cameras. This means that you 
don’t have to create artwork with Processing. You can 
also use it for almost anything you need to code. 
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Matt Richardson delves into the world of Processing, 
the programming language for visual artists 


Physical process 

Processing is especially cool on the Raspberry Pi 
because there’s a library for working with the Pi’s 
GPIO pins. You can therefore have on-screen graphics 
interacting with buttons, switches, LEDs, relays, and 
sensors wired up to your Pi. With Processing, you 
could build a game that uses a custom controller that 
you’ve built yourself. Or you can create a piece of 
artwork that interacts with the user by sensing their 
proximity to it. 

Best of all, Processing is created with learning 
to code in mind. There are tons of built-in 
examples that you can use to learn about many 
different programming and drawing concepts. 

The documentation on Processing’s website is very 
thorough and - like Raspberry Pi — there’s a very 
supportive community around it if you run into any 
trouble. Additionally, the Processing development 
environment is powerful but also very simplified. 
For these reasons, it’s perfect for someone who 

is just getting started. 

To get going with Processing on Raspberry Pi, 
there’s a one-line install command. You can also go 
to Processing.org and download pre-built Raspbian 
images with Processing already installed. To help you 
on your journey, there’s a resource on Raspberry Pi’s 
website for getting started with Processing. It includes 
a walkthrough on how to access the GPIO pins to 
combine physical computing and visual arts. 

When you launch Processing, you will be presented 
with a blank file where you can start keying in your 
code... don’t let that intimidate you. All of the world’s 
greatest pieces of art have started with a raw slab 
of marble, a blob of clay, or a blank canvas. It just 
takes one line of code at a time to generate your 
own masterpiece. 
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Code Club is a nationwide network of volunteer-led after school clubs 
for children aged 9-11. 


We're always looking for people with coding skills to volunteer to run 
a Club at their local primary school, library or community centre for an 
hour a week. 


You can team up with colleagues, a teacher will be there to support 
you and we provide all the materials you'll need to help get children 
excited about digital making. 


There are loads of ways to get involved! 


So to find out more, join us at www.codeclub.org.uk 
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